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This publication is a reference manual 
for the programmer using the assembler 
language (including macro definitions and 
conditional assembly facilities) . This 
publication also contains information 
peculiar to DOS and TOS for the D and F 
assembler. 

Part 1 of this publication presents 
information common to all parts of the 
language. Part 2 contains specific 
information concerning the symbolic machine 
instruction codes and the assembler program 
functions provided for the programmer's 
use. Part 3 of this publication describes 
the conditional assembler and macro 
facilities in the assembler language. 

Appendixes A through P follow Part 3. 
Appendixes A through F are associated with 
Parts 1 and 2 and present such items as a 
summary chart for constants, instruction 
listings, character set representations, 
and other aids to programming. Appendix G 
contains macro facility summary charts, and 
Appendix H discusses table capacities for 
various elements of the language. Appendix 
I is a sample program and assembler listing 
description. Appendix J is a features 
comparison chart of the OS assemblers. 
Appendix K gives examples of the cards 
needed for assembler runs. Appendix L 
contains a description of how another 
version of the assembler can be included in 
the core image library. Appendix M 
describes the output produced by the 
assembler. Appendix N explains the 
diagnostic error messages that can be 
issued by the assembler. Appendix 
contains self-relocating program 
techniques. Appendix P contains sample 
macro definitions. 



Prerequisite for a thorough 
understanding of this publication is a 
basic knowledge of IBM System/360 machine 
instructions. The publications most 
closely related to this are: 



IBM System/360 Principles of 
Operation , Order No. GA22-6821. 



2. 



DOS Data Management Concepts , Order 

No. GC24-3427, or 

IBM System/360 Tape Operating System : 

Data Management Concepts , Order No. 

GC24-3430. 

DOS Supervisor and I/O Macros , Order 
No. GC24-5037, or 

IBM System/360 Tape Operating System : 
Supervisor and Input/Output Macros , 
Order No. GC24-5035. 

DOS System Control and Service , Order 
No. GC24-5036, or 

IBM System/360 Tape Operating System : 
System Control and System Service 
Programs , Order No. GC24-5034. 

DOS System Generation , Order No. 
GC24-5033, or 

IBM System/360 Tape Operating System : 
System Generation and Maintenance , 
Order No. GC24-5015. 



DOS and TOS Utility Macros , 
GC24-5042. 



Order No. 



Titles and abstracts of other related 
publications are listed in the IBM 
System/360 Bibliography , Order 
No. GA22-6822. 
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Section 1. Introduction 



Computer programs may be expressed in 
machine language, i.e., language directly 
interpreted by the computer, or in a 
symbolic language, which is much more 
meaningful to the programmer. The symbolic 
language, however, must be translated into 
machine language before the computer can 
execute the program. This function is 
accomplished by an associated processing 
program called an assembler or a compiler. 



DOS: Assembler D, 10K variant 
Assembler D, 14K variant 
Assembler F 

The requirements and features of the 
variants are described below. Two of the 
assemblers, the DOS Assembler D, 14K 
variant, and the Assembler F contain 
features not supported by the other DOS/TOS 
assemblers. 



Of the various symbolic programming 
languages, assembler languages are closest 
to machine language in form and content. 



Machine Features Required 






o 



The assembler language discussed in this 
manual is a symbolic programming language 
for the IBM System/360. It enables the 
programmer to use all IBM System/ 360 
machine functions, as if he were coding in 
IBM System/360 machine language. 

A program written in the assembler 
language will normally consist of three 
types of instructions: machine 
instructions, assembler instructions, and 
macro instructions. They are all coded in 
a language that can be interpreted by the 
assembler processor program. Machine 
instructions are transformed into machine 
language instruction by instruction. This 
language can be directly interpreted by the 
machine. Their functions are not described 
in this manual. Refer to IBM System/360 
Principles of Operation . 

Assembler instructions are used by the 
assembler during processing to manipulate 
the source program written in the assembler 
language. They are described in this 
manual. 

IBM-supported macro instructions provide 
easy access to the control programs 
supplied by the system under which the 
installation is running. They are 
described in IBM System/360 Tape Operating 
System Supervisor and Input/Output Macros , 
and in DOS Supervisor and I/O Macros . The 
user can also write his own macro 
definitions to obtain easy access to 
precoded sections of code. Writing macro 
definitions is covered in this manual. 

Under the Disk and Tape Operating 
Systems a few different assembler variants 
are available. They are: 

TOS: Assembler D, 10K variant 
Assembler D, 14k variant 



A minimum of 16,384, 24,576, or 65,536 
bytes of main storage as detailed below: 

» 16,384 (16K) bytes of main storage, of 
which at least 10,240 contiguous bytes 
must be available to the assembler. 
This is the core requirement for the 
10K variant DOS and TOS D assemblers. 

• 24,576 (24K) bytes of main storage, of 
which at least 14,336 contiguous bytes 
must be available to the assembler. 
This is the core requirement for the 
14K variant DOS and TOS D assemblers. 

• 65,536 (64K) bytes of main storage, of 
which at least 45,056 contiguous bytes 
must be available to the assembler. 
This is the core requirement for the 
44K DOS F assembler. 

Note : The minimum partition required when 
the assembler is executed in the foreground 
partitions is 2K larger than the minimum 
main storage requirements stated above - 
Additional storage, available to any of the 
assemblers, is used to expand assembler 
tables. For details on how to call a 
specific assembler see Appendix K and the 
DOS and TOS System Generation publications 
(listed in "Preface") . 

• Standard instruction set. 

• One I/O Channel (either multiplexor or 
selector) . 

• One Card Reader (1442N1, 2501, 2520E1, 
or 2540) .•• 

• One Card Punch (1442N1, 1442N2,2520, 
or 2540) ■» , if punched, output is 
desired 

• One Printer (1403, 1404 — continuous 
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forms only, or 1443)*, if a printed 
listing is desired. 

• One 1052 Printer-Keyboard. 

• One 2311, 2314, or 2319 Disk Storage 
Drive. This has the DOS resident 
system pack. 

or 

• One 2400-series Magnetic Tape Unit 

(either 7-track or 9- track) . This has 
the TOS resident system. 

• Three work files. Under the DOS D 
Assembler, 10K Variant: either three 
disk storage extents or three magnetic 
tape units. The devices used must be 
all of the same type; i.e., three 
magnetic tape units, three 2311 disk 
storage extents, or three 2314 or 2319 
disk storage extents. Under the DOS D 
Assembler, 14K Variant, and the DOS F 
Assembler: any combination of disk 
storage extents and/or magnetic tape 
units. The disk storage devices used 
need not be of the same type as that 
of SYSRES. Under the TOS D Assembler, 
10K and 14K Variants: three magnetic 
tape units. The devices used must be 
of the same type as that of SYSRES. 

The allowable disk storage devices are 
the 2311, 2314, and the 2319 Disk Storage 
Drives. The allowable magnetic tape units 
are 2400-series Magnetic Tape Units (either 
7- track or 9-track: if 7-track, the data 
conversion feature is required and the tape 
must be set converter on, translator off, 
odd parity) . 

Under the DOS D Assembler, 10K Variant, 
only the system source statement library is 
supported. Under the DOS D Assembler, 14K 
Variant, and the DOS F Assembler, a private 
source statement library is supported. 
Under the TOS D Assembler, 10K and 14K 
Variants, the standard private library is 
supported. The device used for the private 
library must be of the same type as that of 
SYSRES . 

For the 10K DOS and the 14K TOS D 
assemblers, the assemble-and-execute option 
is an alternative to the DECK option; both 
are not supported for the same assembly. 
For the 14K DOS D assembler and for the F 



A 2400-series Magnetic Tape Unit may be 
substituted for this device. (It may be 
7-track or 9-track. If 7-track is used 
the data conversion feature is required 
and the tape must be set converter on, 
translator off, odd parity.) The 1052 
Printer-Keyboard must be operable if 
device assignment is tape. 



assembler, both options are supported in 
the same assembly. If the 
assemble-and-execute option is chosen, 
SYSLNK is a 2400-series Magnetic Tape Unit 
(9-track or 7-track with the data 
conversion feature) for the tape resident 
system, or a 2311, 2314, or 2319 Disk 
Storage extent (which may be on the system 
resident device) for the disk resident 
system. 

If, for assembly, LINK or CATAL options 
are chosen, the I/O requirements for 
SYSLNK must be met. 



Compatibility between System/360 
Assemblers 

The assemblers described in this manual can 
be used under the Disk or Tape Operating 
System running on an IBM System/360 Model 
30 or larger or on an IBM System/370 
machine, provided that main storage and 
input/output requirements are satisfied. 

The following describes the 
compatibility between: 

• the different DOS/TOS assemblers 

• the DOS/TOS assemblers and the OS 
assemblers 

• the BPS/BOS assemblers and the DOS/TOS 
assemblers. 

Incompatibilities caused by some other part 
of a system than the assembler are not 
described. For example, if a program 
segmented into an overlay structure under 
OS is run under DOS in the same overlay 
structure, V-type address constants that 
reference external data can be invalid. 

The programmer must also realize that 
IBM-supplied macros differ from system to 
system. A DTFCD macro coded for DOS will 
be treated as an undefined operation code, 
if assembled under OS. 

Treatment of erroneous input, as well as 
the assignment, size, and ordering of 
literal pools can also differ among the 
assemblers. 



DOS/TOS Assembler Variants 



The TOS variants and the 10K variant of the 
DOS Assembler D accept the same input and 
produce identical output. A program 
accepted by these variants will also be 
accepted by the 14K variant of the DOS 
Assembler D and Assembler F. Those two 
variants have a few extended features. 
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The DOS Assembler D, 14K variant, 
contains the following features not 
supported by any of the other DOS/TOS 
assemblers: 



• The WXTRN instruction 

• All System/370 instructions. The 
additional instructions are: AXR, 
CLCTL, CLM, HDV, ICM, LCTL, LRDR, 
LRER, MC, MVCL, MXD, MXDR, MXR, SCK, 
SIOF, SRP, STCK, STCM, STCTL , STIDC, 
STIDP, and SXR. 

• The L-type constant 

• SSYSPARM 

The DOS Assembler F contains the 
following features not supported by the 
other DOS/TOS assemblers: 

• Two continuation lines allowed for 
source statements other than macro 
instructions and prototype statements. 
Assembler D only allows one per 
statement . 

• Multiple operands in a DC statement. 

• Bit length specification in DC 
statements. 

• The maximum number of operands in a 
macro instruction or prototype 
statement is 200 as opposed to 100 for 
Assembler D. 

• The maximum size of a character 
expression is 255 characters as 
opposed to 127 for Assembler D. 

• The maximum value of a subscript of 
6SYSLIST is 200 as opposed to 100 for 
Assembler D. 



The DOS/TOS Assemblers and the OS 
Assemblers 



The DOS Assembler F implements the full 
System/360 Operating System assembler 
language at the F level with the following 
exceptions: 

• CXD and DXD statements 

• Q-type address constants 

• The special instructions for 
System/370 and System/360 Models 85 
and 195. 

• The WXTRN instruction 



• The L-type constant 

Source code written for any DOS/TOS 
assembler except the DOS Assembler D, 14K 
variant, will be accepted by the OS 
Assembler F. The 14K variant supports 
SSYSPARM, which is not supported by OS. 



The BOS/BPS Assemblers and the DOS/TOS 
Assemblers 



The DOS/TOS assemblers accept source 
programs written in the IBM System/360 
Basic Programming Support Assembler (8K 
Tape) Language, the IBM 7090/7094 Support 
Package for IBM System/360 Assembler 
Language, and the IBM System/360 Basic 
Operating System (8K Disk) Assembler 
Language with the following restrictions: 

• The XFR instruction is not allowed in 
DOS/TOS. 

• If SET symbols are used in macros 
generated in the source code, LCLx and 
GBLx instructions must be added in 
those macro definitions to declare the 
SET symbols. 

• An MNOTE assembler instruction whose 
operand entry consists solely of a 
message enclosed in apostrophes, is 
given a severity code of one. 

• The logical expression in an AIF 
statement must not be explicit zeros 
or ones. 

Note 1 : The DOS/TOS assemblers accept AIFE 
and AGOB statements. They are treated as 
AIF and AGO statements. 

Note 2 : Assembler control statements 
(AWORK, AOPTN, etc.) should be excluded 
from the input to the DOS/TOS assembler. 
They are treated as undefined operation 
codes. 



The Assembler Language 



The basis of the assembler language is a 
collection of mnemonic symbols which 
represent: 

1. IBM System/360 Operating System 
machine language operation codes. 

2. Operations (auxiliary functions) to be 
performed by the assembler program. 

The language is augmented by other 
symbols, supplied by the programmer, and 
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these symbols are used to represent storage 
addresses or data. Symbols are easier to 
remember and code than their machine 
language equivalents. Use of symbols 
greatly reduces programming effort and 
error. 



MACHINE OPERATION CODES 



The assembler language provides mnemonic 
machine instruction operation codes for all 
machine instructions in the IBM System/360 
Universal Instruction Set, and extended 
mnemonic operation codes for the 
conditional branch instruction. 



For instance, the logic of a program may 
require the same instruction sequence to be 
executed again and again. Rather than code 
this entire sequence each time it is 
needed, the programmer creates a macro 
instruction to represent the sequence, and 
then each time the sequence is needed, the 
programmer simply codes the macro 
instruction statement. During assembly, 
the sequence of instructions represented by 
the macro instruction is inserted in the 
object program. Part 3 of this publication 
discusses the conditional assembly and 
macro facilities. 



The Assembler Program 



1 I 



ASSEMBLER OPERATION CODES 



The assembler language also contains 
mnemonic assembler instruction operation 
codes, used to specify auxiliary functions 
to be performed by the assembler program. 
These are instructions to the assembler 
program itself and, with a few exceptions, 
do not result in the generation of any 
machine language code by the assembler 
program. Certain assembler instructions, 
i.e., conditional assembly instructions, 
affect the order of source statement 
assembly and macro generation or the 
content of generated instructions . 



MACRO INSTRUCTIONS 



The assembler language enables the 
programmer to define and use macro 
instructions. Macro instructions are 
represented by an operation code which, in 
turn, actually stands for a sequence of 
machine and/or assembler instructions that 
accomplish the desired function. 

Macro instructions used in preparing an 
assembler language source program fall into 
two categories: system macro instructions, 
provided by IBM, which relate the object 
program to components of the Basic 
Operating System, and macro instructions 
created by the programmer specifically for 
use in the program at hand, or for 
incorporation in a library, available for 
future use. 

Programmer-created macro instructions 
are used to simplify the writing of a 
program and/or to ensure that a standard 
sequence of instructions is used to 
accomplish a desired function. 



The assembler program, also referred to as 
the "assembler", processes source 
statements written in the assembler 
language. The assembler is separated into 
an assembly section and a conditional 
assembly and macro generation section. 



THE MACRO GENERATION AND CONDITIONAL 
ASSEMBLY SECTION 



Before source statements can be translated 
into actual machine language, macro 
instructions and conditional assembly 
statements within the source program must 
be processed. The source program is read. 
Any programmer macro definitions which 
appear before the main portion of the 
program are stored for use when the macro 
is referenced. (System macro definitions 
are retrieved from the source statement 
library and handled in the same way.) 

The main portion of the program is then 
processed, whenever macro generation or 
conditional assembly is required, the 
generated or conditionally assembled text 
is inserted in the original source program. 
The resultant augmented source program is 
ready for input to the assembly section. 



THE ASSEMBLY SECTION 



Processing a source program involves the 
translation of source statements into 
machine language, the assignment of storage 
locations to instructions and other 
elements of the program, and the 
performance of the auxiliary assembler 
program functions designated by the 
programmer. The output of the assembler 
program is the object program , a machine 
language equivalent of the source program* 



vy 
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The assembler program furnishes a printed 
listing of the source statements and object 
program statements and additional 
information useful to the programmer in 
analyzing his program, such as error 
indications. The object program is in the 
format required by the linkage editor 
component of DOS/TOS. 

The amount of main and secondary storage 
allocated to the assembler program for use 
during processing determines the maximum 
number of certain language elements that 
may be present in the source program. For 
a discussion of these dependencies, see 
Appendix H. 



Programmer Aids 



The assembler program provides auxiliary 
functions that assist the programmer in 
checking and documenting programs, in 
controlling address assignment, in 
segmenting a program, in data and symbol 
definition, in generating macro 
instructions, and in controlling the 
assembly program itself. Mnemonic codes, 
specifying these functions, are provided in 
the language. 

Variety in Data Representation . Decimal, 
binary, hexadecimal, or character 
representation of machine language binary 
values may be employed by the programmer in 
writing source statements. The programmer 
selects the representation best suited to 
his purpose. 

Base Register Address Calculation . As 
discussed in the IBM System/360 Principles 
of Operation manual, the operating system 
addressing scheme requires the designation 
of a base register (containing a base 
address value) and a displacement value in 
specifying a storage location. The 
assembler assumes the clerical burden of 
calculating storage addresses in these 
terms for the symbolic addresses used by 
the programmer. The programmer retains 
control of base register usage and the 
values entered therein. 

Relocatability . The object programs 
produced by the assembler are in a format 
enabling relocation from the originally 
assigned storage area to any other suitable 
area. 



Sectioning and Linking . The assembler 
language and program provide facilities for 
partitioning an assembly into one or more 
parts called control sections . Control 
sections may be added or deleted when 
linkage editing the object program. 
Because control sections do not have to be 
loaded contiguously in storage, a sectioned 
program may be loaded and executed even 
though a continuous block of storage large 
enough to accommodate the entire program 
may not be available. 

The linking facilities of the assembler 
language and program allow symbols to be 
defined in one assembly and referred to in 
another, thus effecting a link between 
separately assembled programs. This 
permits reference to data and/or transfer 
of control between programs. A discussion 
of sectioning and linking is in Section 3 
under "Program Sectioning and Linking." 



Program Listings . A listing of the source 
program statements and the resulting object 
program statements may be produced by the 
assembler for each source program it 
assembles. The programmer can partly 
control the form and content of the 
listing. 

Error Indications . As a source program is 
assembled, it is analyzed for actual or 
potential errors in the use of the 
assembler language. Detected errors are 
indicated in the program listing. 



Assembler- DOS/TOS Relationships 



The assembler program is a component of IBM 
disk and tape operating systems and 
functions under their control. DOS/TOS 
provides the assembler with input /output 
library, and other services needed in 
assembling a source program. In a like 
manner, the object program produced by the 
assembler will normally operate under 
control of DOS/TOS and depend on it for 
input/output and other services. In 
writing the source program, the programmer 
must include statements requesting the 
desired functions from DOS/TOS. (See the 
Supervisor and Input/Output Macros 
publications listed in the "Preface".) 



o 
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Section 2. General Information 



This section presents information about 
assembler language coding conventions, 
assembler source statement structure, 
addressing, and the sectioning and linking 
of programs. 



statement line and, if needed, columns 
16-71 of successive continuation lines. 



Assembler Language Coding Conventions 



This subsection discusses the general 
coding conventions associated with use of 
the assembler language. 



CODING FORM 



A source program is a sequence of source 
statements that are punched into cards. A 
standard assembler card is shown in Figure 
2. These statements may be written on the 
standard coding form, GX28-6509 (Figure 1) , 
provided by IBM. One line of coding on the 
form is punched into one card. The 
vertical columns on the form correspond to 
card columns . 

Space is provided on the form for 
program identification and instructions to 
keypunch operators. None of this 
information is punched into a card. 

The body of the form (Figure 1) is 
composed of two fields: the statement 
field, columns 1-71, and the 
identification-sequence field, columns 
73-80. The identification-sequence field 
is not part of a statement and is discussed 
following the subsection "Statement 
Format . " 

The entries (i.e., coding) composing a 
statement occupy columns 1-71 of a 



CONTINUATION LINES 



When it is necessary to continue a 
statement on another line the following 
rules apply. 

1 . Enter any nonblank character in the 
continuation column (end column plus 
one) of the statement line. 

2. Continue the statement on the next 
line, starting in the continue column. 
Columns to the left of the continue 
column must be blank. 

One continuation line is allowed for the 
D assembler and two continuation lines are 
allowed for the F assembler, except for 
source macro instructions and macro 
prototype statements, which may have more 
than one continuation line (see Part 3) . 



STATEMENT BOUNDARIES 



Source statements are normally contained in 
columns 1-71 of statement lines and columns 
16-71 of any continuation lines. 
Therefore, columns 1, 71, and 16 are 
referred to as the "begin", "end", and 
"continue" columns, respectively. This 
convention may be altered by use of the 
Input Format Control (ICTL) assembler 
instruction discussed later in this 
publication. 
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Figure 1. Coding Form 



T°^ 



NAME 



NAME 



00000000 
i i a 4 5 » 7 a 
11111111 

22222222 

33333333 

44444444 

55555555 

66666666 

7 7 7 7 7 7 7 7 

8 8888888 

9 99 99 9 99 

12 3 4 5 6 7 8 



OPERAND 



COMMENTS 



OPERATION 



00000 

tO 11 12 13 14 
11111 

22222 
33333 
44444 
55555 
66666 
777 7 7 
88888 



99999 

10 11 12 13 14 
6509 



OPERAND 



COMMENT8 



OPERAND 



COMMENTS 



00000 
IS 17 1! IS 20 
11111 

22222 
33333 
44444 
55555 
6666 6 
77777 
88888 
99999 

17 IS 19 20 



00000 

212223 24 25 
11111 

22 2 22 
33-333 
44444 
55*555 
66666 
77777 
88888 
99999 

2122 23 24 



00000 

!6 27 2*29 30 
11111 

22222 
33 3 33 



00000 

31 32 33 34 35 
11111 

22222 
33333 



00000 

30 37 38 3940 
11111 

22222 
3 3 3 3 3 



00000 

41 42 43 44 45 
11111 

22222 
33333 



0000 

4(47 484*90 

1 11 1 1 

22222 
33333 



000 

51 52 53 94 55 
11111 

22222 
33333 



IBM SYSTEM/360 
STANDARD ASSEMBLER CARD 



66666 1 
77777 
88888 
99999 

26 27 2829 30 



66666 
77777 
88888 
99999 

31 32 33.14 35 



66666 
77777 
88888 
99999 

3*37 3*3*40 



66666 
77777 
88888 
9 9 9 9 9 

4142 4344 45 



66666 
777 77 
88888 
99999 

474*4950 



66666 
77777 
88888 
9 9 9 9-9 

52 53 54 55 





St 57 51 5* SO 

11111 

22222 
33333 
44444 
55555 
66666 
77777 
88888 
99999 

58 57 5* 



00000 

6162 83 64 65 
11111 

22222 
33333 
44444 
55555 
66666 
77777 
88888 
99999 

«1 62 6364 



000000 

M 87 88 69 70 71 

111111 

222222 
323333 
444444 
55555 5 
666666 
777777 
8888(8 
999999 

87 68*9 70 71 



KiroicnM vumm 



00000000 

73 74 7578 77 76 7**0 
11111111 

22222222 
3 3 3 3 3 3 3 3 
44444444 
55555555 
66666666 
77777777 
8818(888 
99999999 

73 74 75 7* 77 7* 7» ■ 



Figure 2. Punched Card Form 



STATEMENT FORMAT 



There are two types of 

statements — instructions and comments. 

Instructions may consist of one to four 
entries in the statement field. They are. 



from left to right: a name entry, an 
operation entry, an operand entry, and a 
comments entry. These entries must be 
separated by one or more blanks, and must 
be written in the order stated- Total 
statement size is limited to 187 
characters. If this limit is exceeded, the 
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assembly listing may be incorrect for that 
statement. 

The coding form (Figure 1) is ruled to 
provide an eight^character name field, a 
five-character operation field, and a 
56-character operand and/or comments field. 

If desired, the programmer may disregard 
these boundaries and write the name, 
operation, operand, and comment entries in 
other positions, subject to the following 
rules: 

1. The entries must not extend beyond 
statement boundaries (either the 
conventional boundaries, or as 
designated by the programmer via the 
ICTL instruction) . 

2. The entries must be in proper 
sequence, as stated above. 

3. The entries must be separated by one 
or more blanks. 

4. If used, a name entry must be written 
starting in the begin column. 

5. The name and operation entries must be 
completed in the first line of the 
statement, including at least one 
blank following the operation entry. 

A description of the name, opa ration, 
operand, and comments entries follows: 

Name Entries : The name entry is a symbol 
created by the programmer to identify a 
statement. It consists of one to eight 
alphanumeric characters, the first of which 
must be alphabetic. A name entry is 
usually optional, but, if present, must be 
entered with the first (or only) character 
appearing in the begin column. If the 
begin column is blank, the assembler 
program assumes no name has been entered. 
Blanks must not appear within a name entry, 
whether the symbol was introduced directly 
by the programmer or indirectly by 
conditional assembly or macro generation. 

Operation Entries . The operation entry is 
the mnemonic operation code specifying the 
desired machine operation, macro, or 
assembler function. An operation entry is 
mandatory and must appear in the first 
statement line, starting at least one 
position to the right of the begin column. 
Valid mnemonic operation codes for machine 
and assembler operations are contained in 
Appendixes D and E of this publication. 
Valid operation codes consist of five 
characters or fewer for machine or 
assembler operation codes, and eight 
characters or fewer for macro instruction 
operation codes. No blanks may appear 
within the operation entry. 



Operand Entries . Operand entries are the 
coding that identifies and describes data 
to be acted upon by the instruction, by 
indicating such things as storage 
locations, masks, storage area lengths, or 
types of data. 

Depending on the need of the 
instruction, one or more operands may be 
written. Operands are required for all 
machine instructions. 

Operands must be separated by commas. 
Blanks must not intervene between operands 
and the commas that separate them. 

The operands may not contain embedded 
blanks except as follows: If character 
representation is used to specify a 
constant, a literal, or immediate data in 
an operand, the character string may 
contain blanks, e.g., C*AB D* . 



Comments Entries . Comments are descriptive 
items of information about the program that 
are to be inserted in the program listing. 
All 256 valid characters, including blanks, 
may be used in writing a comment. The 
entry cannot extend beyond the end column 
(normally column 71) , and a blank must 
separate it from the operand. 

In instructions where an operand entry 
is optional but not present and a comments 
entry is desired, the absence of the 
operand entry must be indicated by a comma 
preceded and followed by one or more 
blanks, as follows: 




Instruction Example . The following 
illustrates the use of name, operation, 
operand, and comments entries. A compare 
instruction has been named by the symbol 
COMP; the operation entry (CR) is the 
mnemonic operation code for a 
register- to- register compare operation, and 
the two operands (5, 6) designate the two 
general registers whose contents are to be 
compared. The comments entry reminds the 
programmer that he is comparing "new sum" 
to "old" with this instruction. 

r t t 1 

| Name | Operation | Operand | 

,. + 4 ^ 

jCOMP jCR J 5,6 NEW SUM TO OLD j 

l 4. J J 
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SUMMARY OF INSTRUCTION FORMAT 



The entries in an instruction must always 
be separated by at least one blank and must 
be in the following order: name, 
operation, operand (s) , comment. 

Every statement requires an operation 
entry. Name and comment entries are 
optional. Operand entries are required for 
all machine instructions and most assembler 
instructions . 

The name and operation entries must be 
completed in the first statement line, 
including at least one blank following the 
operation entry. 

The name and operation entries must not 
contain blanks. Operand entries must not 
have blanks preceding or following the 
commas that separate them. 

A name entry must always start in the 
"begin" column. 

If the column after the end column is 
blank, the next line must start a new 
statement. If the column after the end 
column is not blank, the following line 
will be treated as a continuation line. 

All entries must be contained within the 
designated begin, end, and continue column 
boundaries. 



Page of GC24-3414-9 
Revised Nov. 31, 1972 
By TNL: GN33-8157 



r T T T 1 

(Name J Operation | Operand | | 
j. x x x .| 

J +THIS COMMENT IS CONTINUED ON | X | 
| ANOTHER LINE. j j 
I X J 



IDENTIFICATION- SEQUENCE FIELD 



The identification-sequence field of the 
coding form (columns 73-80) is used to 
enter program identification and/or 
statement sequence characters. The entry 
is optional. If the field, or a portion of 
it, is used for program identification, the 
identification is punched in the statement 
cards, and reproduced in the printed 
listing of the source program. 

To aid in keeping source statements in 
order, the programmer may code an ascending 
sequence of characters in this field or a 
portion of it. These characters are 
punched into their respective cards, and, 
during assembly, the programmer may request 
the assembler to verify this sequence by 
use of the Input Sequence Checking (ISEQ) 
assembler instruction. This instruction is 
discussed in Section 5 under "Program 
Control Instructions . " 



CHARACTER SET 



4*% 



COMMENTS STATEMENTS 



Comments statements are used to include a 
programmers notes on an assembly listing. 
(These notes can be helpful during 
debugging and maintenance of a program.) 
Comments statements are only printed in the 
assembly listing. Other than between a 
macro definition header and a macro 
prototype statement, comments statements 
may appear anywhere in the program. 
Extensive notes, or comments, may be 
written by using a series of comments 
statements. 

There are two types of comments 
statements. One type, written with an 
asterisk (*) in the begin column, is used 
for comments on the source program. The 
other type, written with a period in the 
begin column and followed by an asterisk, 
is used for comments on a macro definition. 
This type is further described in Section 
7. 



Source statements are written using the 
following characters: 



Letters 

Digits 

Special 
Characters 



A through Z , and $ , # , a 
through 9 

+ -, = .* ( ) ' / 6 blank 



These characters are represented by the 
card punch combinations and internal bit 
configurations listed in Appendix A. In 
addition, any of the 256 punch combinations 
may be designated anywhere that characters 
may appear between paired apostrophes, in 
comments, and in macro instruction 
operands . 



Assembler Language Structure 



The basic structure of the language can be 
stated as follows. 



An example of the comments statement is: A source statement is composed of: 
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• A name entry (usually optional) . 

• An operation entry (mandatory) . 

• An operand entry (usually 
required) . 

• A comments entry (optional) . 

A name entry is: 

• A symbol. 

An operation entry is: 

• A mnemonic operation code representing 
a machine, assembler, or macro 
instruction. 

An operand entry is: 

• One or more operands composed of one 
or more expressions. An expression is 
composed of a term or an arithmetic 
combination of terms. In general, an 
operand entry should contain 50 or 
fewer terms (see Appendix H) . 

Operands of machine instructions 
generally represent such things as storage 
locations, general registers, immediate 
data, or constant values. Operands of 
assembler instructions provide the 
information needed by the assembler program 
to perform the designated operation. 

Figure 3 depicts this structure. Terms 
shown in Figure 3 are classed as absolute 
or relocatable. Terms are absolute or 



relocatable due to the effect of program 
relocation upon them. (Program relocation 
is the loading of the object program into 
storage locations other than those 
originally assigned by the assembler 
program.) A term is absolute if its value 
does not change upon relocation. A term is 
relocatable if its value changes upon 
relocation. 

The following subsection, "Terms and 
Expressions", discusses these items as 
outlined in Figure 3. 



Terms and Expressions 



TERMS 



Every term represents a value. This value 
may be assigned by the assembler program 
(symbols, symbol length attribute, location 
counter reference) or may be inherent in 
the term itself (self-defining term, 
literal) . 

An arithmetic combination of terms is 
reduced to a single value by the assembler 
program. 

The following material discusses each 
type of term and the rules for its use. 



V 
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Name Entry 



Is a Symbol 
which 1$ an 



Machine 
Instruction 



Ordinary 
Symbol (RT) 



Variable 
Symbol 



Sequence 
Symbol 



1 



Operation Entry 



Is a Mnemonic 
Operation Code 



Assembler 
Instruction 



Macro 
Instruction 



Term 



which may be 
any one of 
the following 



A Symbol 
e.g., BETA 
(AT or RT) 



A Self- 
defining 
Term (AT) 



A Location 
Counter Refer- 
ence i.e.,* 
(RT) 



Exp 



£ 



Operand Entry 



One or more 
Operands that 
are composed 
of an 



A Literal 

• .g.,-F'1259' 

(RT) 



Symbol Length 
Attribute Refer- 
ence e.g., 
L 'Symbol (AT) 



Exp(Exp) 



Exp (Exp, Exp) 



Exp = Expression 



Arithmetic 
Combination 
of Terms 



Other Symbol 

Attribute 
References(AT) 



Decimal 
e.g., 15 



which may be 
any one of 
the following 



Hexadecimal 



Binary 
e.g.,B'101 l 



Character 
e.g.,C'AB9' 



AT = Absolute Term 
RT= Relocatable Term 



© 



May be generated by combination of variable symbols and assembler language characters. (Conditional assembly only) 
Conditional assembly only. 



Figure 3. Assembler Language Structure — Machine, Assembler, and Macro Instructions 
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S ymbols 



A symbol is a character or combination of 
characters used to represent locations or 
arbitrary values. Symbols, through their 
use in name fields and in operands, provide 
the programmer with an efficient way to 
name and reference a program element. 
There are three types of symbols: 

1 . Ordinary symbols. 

2. Variable symbols. 

3. Sequence symbols. 

Ordinary symbols consist of one to eight 
letters and/or numbers, the first of which 
must be a letter. Such symbols are used to 
identify machine locations or arbitrary 
values. In the following sections, the 
occurrence of symbol refers to this type of 
term. Absolute symbols are ordinary 
symbols whose values do not change upon 
program relocation. Relocatable symbols 
are ordinary symbols whose values change 
upon relocation. 

The following are valid ordinary 
symbols: 

READER 

A23456 

X4F2 

L00P2 

N 

aB4 

$A1 
#56 

It is advisable to avoid using symbols 
beginning with IJ; they may conflict with 
IOCS symbols (which begin with I J) . 

It is also advisable to avoid using 
symbols which are identical to a file name 
(name field) in a DTF statement with a 
single character suffix. For example, for 
the file name RECIN, IOCS generates the 
symbols: RECIN1, RECIN2, RECIN3, etc. 

The following ordinary symbols are 
invalid, for the reasons noted: 

256B First character is not 

alphabetic. 

REC0RDAREA2 More than eight characters. 

BCD*34 Contains a special 

character — an asterisk. 

IN AREA Contains a blank. 

Variable symbols must begin with an 
ampersand (S) followed by one to seven 
letters and/or numbers, the first of which 



must be a letter. Variable symbols are 
used within the source program or macro 
definition to allow different values to be 
assigned to one symbol. A complete 
discussion of variable symbols appears in 
Part 3. 

Sequence symbols consist of a period (.) 
followed by one to seven letters and/or 
numbers, the first of which must be a 
letter. Sequence symbols are used to 
indicate the position of statements within 
the source program or macro definition. 
Through their use the programmer can vary 
the sequence in which statements are 
processed by the assembler program. (See 
the complete discussion in Part 3.) 

Note : Sequence symbols and variable 
symbols are used only for the macro 
language and for conditional assembly. 
Programmers who do not use these features 
need not be concerned with these symbols. 

DEFINING SYFBOLS : The assembler assigns a 
value to each symbol appearing as a name 
entry in a source statement. The values 
assigned to symbols naming storage areas, 
instructions, constants, and control 
sections are the addresses of the leftmost 
bytes of the storage fields containing the 
named items. Since the addresses of these 
items may change upon program relocation, 
the symbols naming them are considered 
relocatable terms. -- 

A symbol used as a name entry in the 
Equate Symbol (EQU) assembler instruction 
is assigned a value designated in the 
operand entry of the instruction. Since 
the operand entry may represent a 
relocatable value, or an absolute (i.e., 
nonchanging) value, the symbol is 
considered a relocatable term or an 
absolute term, depending on the value to 
which it is equated. 

The value of a symbol may not be 
negative and may not exceed 2 2< *-1. 

A symbol is said to be defined when it 
appears as the name of a source statement. 
(A special case of symbol definition is 
discussed in Section 3, under "Program 
Sectioning and Linking".) 

Symbol definition also involves the 
assignment of a length attribute to the 
symbol. (The assembler maintains an 
internal table — the symbol table — in which 
the values and attributes of symbols are 
kept. When the assembler encounters a 
symbol in an operand, it refers to the 
table for the values associated with the 
symbol.) The length attribute of a symbol 
is the length, in bytes, of the storage 
field whose address is represented by the 
symbol. For example, a symbol naming an 



\A m 



22 Part 1: Introduction to the Assembler Language 



instruction that occupies four bytes of 
storage has a length attribute of 4. Note 
that there are exceptions to this rule; for 
example, in the case where symbol has been 
defined by an equate to location counter 
value (EQU *) or to a self- defining term, 
the length attribute of the symbol is 1 . 
These and other exceptions are noted under 
the instructions involved. The length 
attribute is never affected by a 
duplication factor. 

PREVIOUSLY DEFINED SYMBOLS ; The assembler 
language requires that symbols appearing in 
the operand entry of some instructions be 
previously defined. This simply means that 
the symbols, before their use in an 
operand, must have appeared as the name 
entry of a prior statement. For example: 



SYM1 
SYM2 



MVC 
EQU 



A,B 
SYM1 



language binary value or bit configuration 
they represent. 

Self ~def ining terms are classed as 
absolute terms because the values they 
represent do not change upon program 
relocation. 



USING SELF-DEFINING TERMS : Self -defining 
terms are the means of specifying machine 
values or bit configurations without 
equating the values to symbols and using 
the symbols. Self- defining terms may be 
used to specify such program elements as 
immediate data, masks, registers, 
addresses, and address increments. 

The use of a self-defining term is quite 
distinct from the use of data constants or 
literals. When a self-defining term is 
used in a machine instruction statement, 
its value is assembled into the 
instruction. When a data constant or 
literal is specified in the operand of an 
instruction, its address is assembled into 
the instruction. 



O 



would be a valid sequence of coding. The 
same two instructions in reverse order 
would be invalid. 

GENERAL RESTRICTIONS ON SYMBOLS : A symbol 
may be defined only once in an assembly. 
While the same symbol may appear as the 
name of two or more statements before macro 
generation and conditional assembly, only 
one such statement should be generated. In 
addition, a symbol may be used in the name 
field more than once as a control section 
name (i.e., defined in the START, CSECT, or 
DSECT assembler statements described in 
Section 3) because the coding of a control 
section may be suspended and then resumed 
at any subsequent point. The CSECT or 
DSECT statement that resumes the section 
must be named by the same symbol that 
initially named the section; thus, the 
symbol that names the section must be 
repeated. Such usage is not considered to 
be duplication of a symbol definition. 



Decimal Self-Defining Term . A decimal term 
is simply an unsigned decimal number 
written as a sequence of decimal digits. 
High-order zeros may be used (e.g., 007). 
Limitations on the value of the term depend 
on its use . For example , a decimal term 
that designates a general register must 
have a value between and 15 inclusively; 
one that represents an address must not 
exceed the size of storage. In any case, a 
decimal term may not consist of more than 
eight digits or exceed 16,777,215 (2 24 »-1). 
A decimal term is assembled as its binary 
equivalent. Some examples of decimal 
self-defining terms are: 8, 147, 4092, 
00021. 



Hexadecimal Self-Defining Term . A 
hexadecimal self-defining term is a 
sequence of one to six hexadecimal digits. 
The digits must be enclosed in single 
apostrophes and preceded by the letter X: 
X'C^*. 






Self-Defining Terms 



A self-defining term is one whose value is 
inherent in the term. It is not assigned a 
value by the assembler program. For 
example, the decimal self- defining 
term — 15 — represents a value of fifteen. 

There are four types of self -defining 
terms: decimal, hexadecimal, binary, and 
character. Use of these terms is spoken of 
as decimal, hexadecimal, binary, or 
character representation of the machine 



Each hexadecimal digit is assembled as 
its four-bit binary equivalent. Thus,* a 
hexadecimal term used to represent an 
eight-bit mask would consist of two 
hexadecimal digits. The maximum value of a 
hexadecimal term is X'FFFFFF* . 

The hexadecimal digits and their bit 
patterns are as follows: 



0- 0000 4- 0100 

1- 0001 5- 0101 

2- 0010 6- 0110 

3- 0011 7- 0111 



8- 1000 C- 1100 

9- 1001 D- 1101 
A- 1010 E- 1110 
B- 1011 F- 1111 
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A table for converting from hexadecimal 
representation to decimal representation is 
provided in Appendix B. 

Binary Self -Defining Term . A binary 
self-defining term is written as an 
unsigned sequence of 1's and O's enclosed 
in apostrophes and preceded by the letter 
B, as follows: B' 10001101*. This term 
would appear in storage as shown, occupying 
one byte. A binary term may have up to 24 
bits represented. Padding with binary 
zeros is on the left. 

Binary representation is used primarily 
in designating bit patterns of masks or in 
logical operations. 

The following example illustrates a 
binary term used as a mask in a Test Under 
Mask (TM) instruction. The contents of 
GAMMA are to be tested, bit by bit, against 
the pattern of bits represented by the 
binary term. 

r " T- 1 1 

|Name | Opera tion| Operand | 

|. f f .( 

j ALPHA JTM j GAMMA, B' 10101 101 • j 

l i. JL J 

Character Self-Defining Term . A character 
self -defining term consists of one to three 
characters enclosed by apostrophes. It 
must be preceded by the letter C. All 
letters, decimal digits, and special 
characters may be used in a character term. 
In addition, any of the remainder of the 
256 punch combinations may be designated in 
a character self-defining term. Examples 
of character self-defining terms are as 
follows : 



C'ABC 



C • (blank) 
CIS* 



Because of the use of apostrophes in the 
assembler language and ampersands in the 
macro language as syntactic characters, the 
following rule must be observed when using 
these characters in a character term. 



Location Counter Reference 



A location counter is used to assign 
storage addresses to program statements. 
It is the assembler program's equivalent of 
the instruction counter in the computer. 
As each machine instruction or data area is 
assembled, the location counter is first 
adjusted to the proper boundary for the 
item, if adjustment is necessary, and then 
incremented by the length of the assembled 
item. Thus, it always points to the next 
available location. If the statement is 
named by a symbol, the value assigned to 
the symbol is the value of the location 
counter after boundary adjustment, but 
before addition of the length. 



The assembler maintains a location 
counter for each control section of the 
program and manipulates each location 
counter as previously described. Source 
statements for each section are assigned 
addresses from the location counter for 
that section. The location counter for 
each successively declared control section 
assigns locations in consecutively higher 
areas of storage. If a program has 
multiple control sections, all statements 
identified as belonging to the first 
control section will be assigned from the 
location counter for section 1 , the 
statements for the second control section 
will be assigned from the location counter 
for section 2, etc. This procedure is 
followed whether the statements from 
different control sections are interspersed 
or written in control section sequence. 



The location counter setting can be 
controlled by using the START and ORG 
assembler instructions, which are described 
in Sections 3 and 5, respectively. The 
counter affected by either of these 
assembler instructions is the counter for 
the control section in which they appear. 
The maximum value for the location counter 
is 2 a *-1. 



J 



For each apostrophe or ampersand desired 
in a character term, two apostrophes or 
ampersands must be written. For example, 
the character value A'# would be written as 
C'A"!', while an apostrophe followed by a 
blank and another apostrophe would be 
written as C« •-• ' • ' . 

Each character in the character sequence 
is assembled as its eight-bit code 
equivalent (see Appendix A) . The two 
apostrophes or ampersands that must be used 
to represent a single apostrophe or 
ampersand within the character sequence are 
assembled as a single apostrophe or 
ampersand. 



The programmer may refer to the current 
value of the location counter at any place 
in a program, by using an asterisk in an 
operand. The asterisk represents the 
location of the first byte of currently 
available storage (i.e. , after any required 
boundary adjustment) . Using an asterisk in 
a machine instruction statement is the same 
as placing a symbol in the name field of 
the statement and then using that symbol as 
an operand of the statement. Because a 
location counter is maintained for each 
control section, a location counter 
reference designates the location counter 
for the section in which the reference 
appears . 



'On 
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A reference to the location counter may 
be made in a literal address constant 
(i.e., the asterisk may be used in an 
address constant specified in literal 
form) . The address of the instruction 
containing the literal is used for the 
value of the location counter . A location 
counter reference may not be used in a 
statement which requires the use of a 
predefined symbol, with the exception of 
the EQU and ORG assembler instructions. 



Literals 



A literal term is one of three basic ways 
to introduce data into a program. It is 
simply a constant preceded by an equal sign 



A literal represents data rather than a 
reference to data. The appearance of a 
literal in a source statement directs the 
assembler program to assemble the data 
specified by the literal, store this data 
in a "literal pool", and place the value 
(address) of the storage field containing 
the data in the operand field of the 
assembled statement. 

Literals provide a means of entering 
constants (such as numbers for calculation, 
addresses, indexing factors, or words or 
phrases for printing out a message) into a 
program by specifying the constant in the 
operand of the instruction in which it is 
used. This is in contrast to using the DC 
assembler instruction to enter the data 
into the program, and then using the name 
of the DC instruction in the operand. Only 
one reference to a literal is allowed in a 
machine instruction statement. 

A literal term may not be combined with 
any other terms. 

A literal may not be used as the 
receiving field of an instruction that 
modifies storage. 

A literal may not be specified in an 
address constant (see "DC — Define Constant" 
in Section 5) . A literal may not be 
specified in a shift instruction or an I/O 
instruction (HIO, HDV, SIO, SIOF, STIDC, 
TIO) . 

A literal may not have an explicit base 
or an explicit index when specified in an 
instruction . 

The instruction coded below shows one 
use of a literal. 



r T~ t "i 

| Name | Operation | Operand | 

j. + x 1 

| GAMMA JL j10,=F r 274» j 

i x J . J 

The statement GAMMA is a load 
instruction using a literal as the second 
operand. When assembled, the second 
operand of the instruction will be the 
address at which the binary value 
represented by F*274 r is stored. 

Note ; If the type subfield of the operand 
is C, X, or B and the equal sign (=1 is 
omitted, you have not written a literal but 
a self-defining term which the assembler may 
assemble without error (see "Using Self- 
Defining Terms") . P^'5/^( 

In general, literals may be used 
wherever a storage address is permitted as 
an operand. They may not, however, be used 
in any assembler instruction. Literals are 
considered relocatable, because the address 
of the literal, rather than the literal 
itself, will be assembled in the statement 
that employs a literal. The assembler 
generates the literals, collects them, and 
places them in a specific area of storage, 
as explained in the subsection "The Literal 
Pool." A literal is not to be confused 
with the immediate data in an SI 
instruction. Immediate data is assembled 
into the instruction. 

Literal Format . The assembler requires a 
description of the type of literal being 
specified as well as the literal itself. 
This descriptive information assists the 
assembler in assembling the literal 
correctly. The descriptive portion of the 
literal must indicate the format in which 
the constant is to be assembled. It may 
also specify the length the constant is to 
occupy. 

The method of describing and specifying 
a constant as a literal is nearly identical 
to the method of specifying it in the 
operand of a DC assembler instruction. The 
major difference is that the literal must 
start with an equal sign (=) , which 
indicates to the assembler that a literal 
follows. See the discussion of the DC 
assembler instruction operand format 
(Section 5) for the means of specifying a 
literal. The type of literal designated in 
an instruction is not checked for 
correspondence with the operation code of 
the instruction. 

Some examples of literals are: 

=A (BETA) - address constant literal. 
=F , 1234 f - a fixed-point number with a 

length of four bytes. 
^•ABC* - a character literal. 
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The Literal Pool . The literals processed 
by the assembler are collected and placed 
in a special area called the literal pool, 
and the location of the literal, rather 
than the literal itself, is assembled in 
the statement employing a literal . The 
positioning of the literal pool may be 
controlled by the programmer, if he so 
desires. Unless otherwise specified, the 
literal pool is placed at the end of the 
first control section. 

The programmer may also specify that 
multiple literal pools be created. 
However, the sequence in which literals are 
ordered within the pool is controlled by 
the assembler. Further information on 
positioning the literal pool (s) is in 
Section 5 under "LTORG— Begin Literal 
Pool." 

Duplicate Literals . If duplicate literals 
occur within one literal pool, only one 
literal is stored. Literals are considered 
duplicates only if their specifications are 
identical. A literal will be stored, even 
if it appears to duplicate another literal, 
if it is an A-type address constant 
containing any reference to the location 
counter . 

The following examples illustrate the 
foregoing rules: 



X'FO* 
C'O* 
XLS'O' 
HLS'O* 
A (*+4) | 
A(**4) J 
X'FFFF 1 
X/FFFF 1 



Both are stored. 



Both are stored. 



Both are stored. 



Identical; the first is stored. 



For ease in following the example, the 
length attributes of A1 and B2 are 
mentioned. 

r t "* t 1 

(Name (Operation {Operand j 

,. _ + + .j 

|A1 |DS |CL8 | 

JB2 |DC |CL2 , AB* | 

JHIORD JMVC |A1 (L«B2) ,B2 j 

JLOORD JMVC |AHL , A1-L , B2 (L f B2) ,B2 j 

L A — L . J 

A1 names a storage field eight bytes in 
length and is assigned a length attribute 
of eight. E2 names a character constant 
two bytes in length and is assigned a 
length attribute of two. The statement 
named HIORD moves the contents of B2 into 
the leftmost two bytes of A1 . The term 
L*B2 in parentheses provides the length 
specification required by the instruction. 
When the instruction is assembled, the 
length is placed in the proper field of the 
machine instruction. 

The statement named LOORD moves the 
contents of B2 into the rightmost two bytes 
of A1. The combination of terms 
A1+L , A1-L , B2 results in the addition of the 
length of A1 to the beginning address of 
A1, and the subtraction of the length of B2 
from this value. The result is the address 
of the seventh byte in field A1. The 
constant represented by B2 is moved into A1 
starting at this address. L'B2 in 
parentheses provides length specification 
as in HIORD. 

Note ; The length attribute of * is equal 
to the length of the instruction in which 
it appears, except in an EQU to * 
instruction where the length attribute is 
1. 



EXPRESSIONS 



(j 



U y 



Symbol Length Attribute Reference 



The length attribute of a symbol may be 
used as a term by coding L* followed by the 
symbol, as in: 

L'BETA 

The length attribute of BETA will be 
substituted for the term. The following 
example illustrates the use of L' symbol in 
moving a character constant into either the 
high-order or low-order end of a storage 
field. 



Expressions, which are used in coding 
operand entries for assembler language 
statements, are composed of either a single 
term or an arithmetic combination of terras 
(see Figure 3) . Arithmetically combined 
terms, enclosed in parentheses, may be use 
in combination with terms outside the 
parentheses. For example: 

U+BETA- (GAMMA-LAMBDA) 

When terms in parentheses occur in 
combination with other terms, like 
(GAMMA-LAMBDA) in the example, the 
parenthesized terms are reduced first to a 
single value. This value may be absolute 
or relocatable, depending on the 
combination of terms. This value then is 
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used in reducing the rest of the 
combination to another single value. 



Parenthesized terms may be included 
within another set of terms in parentheses. 
For example: 

A+B- (C+D~ (E+F) +10) 

This expression has two levels of 
parentheses. A level of parentheses is a 
left parenthesis and its matching right 
parenthesis. One level of parentheses 
surrounds E+F. The next higher level of 
parentheses surrounds C+D- (E+F) +1 0. The 
innermost set of terms in parentheses (the 
lowest level) is evaluated first. 

The following are examples of valid 
expressions: 



AREA1+X"2D a 
♦ ♦32 
N-25 

FIELD+332 
FIELD 



BETA* 10 
B'101" 
C'ABC* 
29 

L« FIELD 
LAMBDA+GAMMA 



o 



(EXIT- ENTRY* 1) +GO TEN/TWO 
=F , 1234* 

ALPHA- BETA/ (10+AREA*L g FIELD) -100 
A* (A* (A* (A+1) +3* (B-3) ) ) 

The rules for coding expressions are: 

1 . An expression may not start with an 
arithmetic operator, that is, + - / *. 
Therefore, the expression -A+BETA is 
invalid. However, the expression 
0-A+BETA is valid. 

2. An expression may not contain two 
terms or two operators in succession. 

3. An expression may not consist of more 
than 16 terms. 

4. An expression may not have more than 
five levels of parentheses* 

5. A multiterm expression may not contain 
a literal. 



Evaluation of Expressions 



A single term expression, e.g., 2 9, BETA, 
*, L f SYMBOL, takes on the value of the term 
involved . 

A multiterm expression, e.g., BETA+10, 
ENTRY-EXIT, 25*10+A/B, is reduced to a 
single value, as follows: 

1. Each term is given its value. 



2. Arithmetic operations are performed 
left to right. Multiplication and 
division are done before addition and 
subtraction, e.g., A+B*C is evaluated 
as A+ (B*C) , not (A+B) *C. The computed 
result is the value of the expression. 

3. Every expression is computed to 32 
bits, and then truncated to the 
rightmost 24 bits. 

4. Division always yields an integer 
result; any fractional portion of the 
result is dropped. E.g., 1/2*10 
yields a zero result, whereas 10*1/2 
yields 5. 

5. Division by zero is valid and yields a 
zero result. 

Parenthesized expressions used in an 
expression are processed before the rest of 
the terms in the expression, e.g., in the 
expression A+BETA* (CON- 10) , the term CON-10 
is evaluated first and the resulting value 
is used in computing the final value of the 
expression. 

Negative values are carried in two's 
complement form. Final values of 
expressions are the rightmost 24 bits of 
the results. Intermediate results have a 
range of -2 3a through 2 3i -1. However, the 
value of an expression before truncation 
must be in the range -2 2 *» through 2 a *-1 or 
the results will be meaningless. A 
negative result is considered to be a 
3-byte positive value. 

Note : In A- type address constants, the 
full 32 bit final result is truncated on 
the left to fit the specified or implied 
length of the constant. 



Absolute and Relocatable Expressions 



An expression is called absolute if its 
value is unaffected by program relocation. 

An expression is called relocatable if 
its value changes upon program relocation. 

The two types of expressions, absolute 
and relocatable, take on these 
characteristics from the term or terms 
composing them. The following material 
discusses this relationship. 

Absolute Expression . An absolute 
expression may be an absolute term or any 
arithmetic combination of absolute terms. 
An absolute term may be an absolute symbol, 
any of the self -defining terms, or the 
length attribute reference. As indicated 
in Figure 3, all arithmetic operations are 
permitted between absolute terms. 
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An absolute expression may contain 
relocatable terms (RT) — alone or in 
combination with absolute terms (AT) — under 
the following conditions: 



1. There must be an even number of 
relocatable terms in the expression. 

2. The relocatable terms must be paired. 
Each pair of terms must have the same 
relocatability attribute, i.e., they 
appear in the same control section in 
this assembly (see "Program Sectioning 
and Linking" , Section 3) . Each pair 
must consist of terms with opposite 
signs. The paired terms do not have 
to be contiguous, e.g., RT+AT-RT. 

3. No relocatable expression may enter 
into a multiply or divide operation. 
Thus, RT-RT*10 is invalid. However, 

(RT-RT) *10 is valid. 

The pairing of relocatable terms (with 
opposite signs and the same relocatability 
attribute) cancels the effect of 
relocation. Therefore the value 
represented by the paired terms remains 
constant, regardless of program relocation. 
For example, in the absolute expression 
A-Y+X, A is an absolute term, and X and Y 
are relocatable terms with the same 
relocatability attribute. If A equals 50, 
Y equals 25, and X equals 10, the value of 
the expression would be 35. If X and Y are 
relocated by a factor of 100 their values 
would then be 125 and 110. However, the 
expression would still evaluate as 35 
(50-125+110=35). 

An absolute expression reduces to a 
single absolute value. 

The following examples illustrate 
absolute expressions. A is an absolute 
terra; X and Y are relocatable terms, with 
the same relocatability attribute. 

A-Y*X 

A 

A*A 

X-Y+A 

*-Y (a reference to the location counter 

must be paired with another 

relocatable term from the same control 

section, i.e., with the same 

relocatability attribute) 



Relocatable Expressions . A relocatable 
expression is one whose value would change 
by n if the program in which it appears is 
relocated n bytes away from its originally 
assigned area of storage. 



A relocatable expression may be a 
relocatable term. A relocatable expression 
may contain relocatable terms — alone or in 
combination with absolute terms — under the 
following conditions; 

1 . There must be an odd number of 
relocatable terms. 

2. All the relocatable terms but one must 
be paired. Pairing is described in 
"Abso lute Expr es sion . " 

3. The unpaired term must not be directly 
preceded by a minus sign. 

4. No relocatable term may enter into a 
multiply or divide operation. 

A relocatable expression reduces to a 
single relocatable value. This value is 
the value of the odd relocatable term, 
adjusted by the values represented by the 
absolute terms and/or paired relocatable 
terms associated with it. 

For example, in the expression W-X+W-10, 
W and X are relocatable terms with the same 
relocatability attribute. If initially W 
equals 10 and X equals 5, the value of the 
expression is 5. However, upon relocation 
this value will change. If a relocation 
factor of 100 is applied, the value of the 
expression is 105. Note that the value of 
the paired terms, W-X, remains constant at 
5 regardless of relocation. Thus, the new 
value of the expression, 105, is the result 
of the value of the odd term (W) adjusted 
by the values of W-X and 10. 

The following examples illustrate 
relocatable expressions. A is an absolute 
term, W and X are relocatable terms with 
the same relocatability attribute, Y is a 
relocatable term with a different 
relocatability attribute. 



O 



/4 "X 



Y-32*A W-X+* 
W-X+Y 

* (reference to 
location counter ) 



=F»1234« (literal) 

A*A*W-W+Y 

W-X+W 

Y 
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Section 3. Addressing-Program Sectioning and Linking 



Addressing 



BASE REGISTER INSTRUCTIONS 



o 



The IBM System/360 Operating System 
addressing technique requires the use of a 
base register, which contains the base 
address, and a displacement, which is added 
to the contents of the base register. The 
programmer may specify a symbolic address 
and request the assembler to determine its 
storage address in terms of a base register 
and a displacement. The programmer may 
rely on the assembler to perform this 
service for him by indicating which general 
registers are available for assignment and 
what values the assembler may assume each 
contains. The programmer may use as many 
or as few registers for this purpose as he 
desires. The only requirements are that, 
at the point of reference, a register 
containing an address from the same control 
section is available, and that this address 
is less than or equal to the address of the 
item to which the reference is being made. 
The difference between the two addresses 
may not exceed 4 095 bytes. 



ADDRESSES— EXPLICIT AND IMPLIED 



An address is composed of a displacement 
plus the contents of a base register. (In 
the case of RX instructions, the contents 
of an index register are also used to 
derive the address.) 



The USING and DROP assembler instructions 
enable programmers to use expressions 
representing implied addresses as operands 
of machine instruction statements, leaving 
the assignment of base registers and the 
calculation of displacements to the 
assembler. 



In order to use symbols in the operand 
field of machine instruction statements, 
the programmer must (1) indicate to the 
assembler, by means of a USING statement, 
that one or more general registers are 
available for use as base registers, (2) 
specify, by means of the USING statement, 
what value each base register contains, and 
(3) load each base register with the value 
he has specified for it. 



Having the assembler determine base 
registers and displacements relieves the 
programmer of separating each address into 
a displacement value and a base address 
value. This feature of the assembler will 
eliminate a likely source of programming 
errors, thus reducing the time required to 
check out programs. To take advantage of 
this feature, the programmer uses the USING 
and DROP instructions described in this 
subsection. The principal discussion of 
this feature follows the description of 
both instructions. 



o 



The programmer writes an explicit 
address by specifying the displacement and 
the base register number. In designating 
explicit addresses a base register may not 
be combined with a relocatable symbol. 



He writes an implied address by 
specifying an absolute or relocatable 
address. The assembler has the facility to 
select a base register and compute a 
displacement, thereby generating an 
explicit address from an implied address, 
provided that it has been informed (1) what 
base registers are available to it and (2) 
what each contains. The programmer conveys 
this information to the assembler through 
the USING and DROP assembler instructions. 



USING — Use Base Address Register 



The USING instruction indicates that one or 
more general registers are available for 
use as base registers. This instruction 
also states the base address values that 
the assembler may assume will be in the 
registers at object time. Note that a 
USING instruction does not load the 
registers specified. It is the 
programmer's responsibility to see that the 
specified base address values are placed 
into the registers. Suggested loading 
methods are described in the subsection 
"Programming with the USING Instruction. " 
The typical form of the USING instruction 
statement is: 
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| Name J Opera tion| Operand | 

j. x x ) 

| Sequence | USING |From 2-17 expressions! 
| symbol orj j of the form v,r1, j 
jnot used j j r2,r3,. . . ,r 16 j 

L_^ J. X J 



Operand v must be an absolute or 
relocatable expressiop with a value ranging 
from -2 a * to + 2 2< »-1. No literals are 
permitted. Operand v specifies a value 
that the assembler can use as a base 
address. The other operands must be 
absolute expressions. The operand r1 
specifies the general register that can be 
assumed to contain the baseV x address 
represented by operand v. Operands r2, r3, 
r4,... specify registers that can be 
assumed to contain v+4096, v+8192, 
v+12288,. .. , respectively. The values of 
the operands r1, r2, r3 , . . . , r16 must be 
between and 15. For example, the 
statement : 



2. Register must be specified as 
operand r1. 

Ihe assembler assumes that register 
contains zero. Therefore, regardless of 
the value of operand v, it calculates 
displacements as if operand v were absolute 
or relocatable zero. The assembler also 
assumes that subsequent registers specified 
in the same USING statement contain 4096, 
8192, etc. 

Note ; If register is used as a base 
register, the program is not relocatable, 
despite the fact that operand v may be 
relocatable. The program can be made 
relocatable by: 

1. Replacing register in the USING 
statement. 

2. Loading the new register with a 
relocatable value. 

3. Reassembling the program. 



o 



r r 1 1 

|Name | Opera tion| Operand | 

j. x x __ H 

| | USING |*, 12, 13 | 

I x J. j 

tells the assembler it may assume that the 
current value of the location counter will 
be in general register 12 at object time, 
and that the current value of the location 
counter, incremented by 4096, will be in 
general register 13 at object time. 

If the programmer changes the value in a 
base register currently being used, and 
wishes the assembler to compute 
displacement from this value, the assembler 
must be told the new value by means of 
another" USING statement. In the following 
sequence the assembler first assumes that 
the value of ALPHA is in register 9. The 
second statement then causes the assembler 
to assume that ALPHA+1000 is the value in 
register 9. 

r t — t 1 

| Name | Operation) Operand j 

j. x _ x i 

| | USING | ALPHA, 9 j 

I !• I I 

I !• I I 

j j USING j ALPHA+1000, 9 j 

l X X J 

If the programmer has to refer to the 
first 4096 bytes of storage, he can use 
general register as a base register 
subject to the following conditions: 

1 . The value of operand v must be either 
an absolute or relocatable zero or 
simply relocatable. 



DROP — Drop Base Register 



The DROP instruction specifies a previously 
available register that may no longer be 
used as a base register. The typical form 
of the DROP instruction statement is as 
follows: 



I Name 



F 

j Sequence J DROP 
j symbol orj 
not used 



"7 T 

|Operation | Operand 



jUp to 16 absolute 
| expressions of the 
j form r1 ,r2, 
|r3,...,r16 
-X 



Ihe expressions indicate general 
registers previously specified in a USING 
statement that are now unavailable for base 
addressing. The following statement, for 
example, prevents the assembler from using 
registers 7 and 11: 

r t t 1 

| Name J Operation | Operand J 

f x x 1 

| j DROP 1 7, 11 | 

L 1 X J 

It is not necessary to use a CROP 
statement when the base address in a 
register is changed by a USING statement; 
nor are DROP statements needed at the end 
of the source program. 

A register made unavailable by a CROP 
instruction can be made available again by 
a subsequent USING instruction. 
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PROGRAMMING WITH THE USING INSTRUCTION 



The USING (and DROP) instructions may be 
used anywhere in a program, as often as 
needed, to indicate the general registers 
that are available for use as base 
registers and the base address values the 
assembler may assume each contains at 
execu ion time. Whenever an address is 
specified in a machine instruction 
statement, the assembler determines whether 
there is an available register containing a 
suitable base address. The USING 
instruction establishes addressability at 
assembly time, assuming that the registers 
assigned as base registers have been loaded 
with correct base addresses. Any reference 
to relocatable or absolute terms, which are 
to be assembled into the base displacement 
form, such as names in the operand of a 
machine instruction or S-type address 
constant, must come after the pertinent 
USING instruction that makes the terms 
addressable. References to terms 
relocatable or otherwise in the operand of 
an A-type or Y-type address constant do not 
have to be preceded by a USING statement. 
A register is considered available for a 
relocatable address if it was assigned a 
relocatable value that is in the same 
control section as the address. A register 
assigned an absolute value is available for 
addressing absolute locations only. In 
either case the base address is considered 
suitable only if it is less than or equal 
to the address of the item to which the 
reference is made. The difference between 
the two addresses may not exceed 4095 
bytes. In calculating the base register to 
be used, the assembler always uses the 
available register giving the smallest 
displacement. If there are two registers 
with the same value, the highest numbered 
register is used. 



r 7 t 

I Name | Operation! Operand 



h 



| BEGIN | BALR 
[ j USING 
[ALPHA !• 



J 



BE1A 



END 



2,0 
*,2 



BEGIN 



In the preceding sequence, the BALR 
instruction loads register 2 with the 
address of the first storage location 
immediately following. In this case, it is 
the address of the instruction named ALPHA. 
The USING instruction indicates to the 
assembler that register 2 contains this 
location. When employing this method, the 
USING instruction must immediately follow 
the BALR instruction. No other USING or 
load instructions are required if the 
location named BETA is within 4095 bytes of 
ALPHA. 

In Figure 4 the BALR and LM instructions 
load registers 2-5. The USING instruction 
indicates to the assembler that these 
registers are available as base registers 
for addressing a maximum of 16,384 
consecutive bytes of storage , beginning 
with the location named HERE. The number 
of addressable bytes may be increased or 
decreased by altering the number of 
registers designated by the USING and LM 
instructions and the number of address 
constants specified in the DC instruction. 



Note : Care must be taken when assigning 
base registers to avoid using, except under 
special circumstances: 

1. General registers 0, 1, 13, 14 and 15, 
as they are used by the system. 

2. Any register used explicitly or 
implicitly by a machine instruction. 






j Name 
fBEGTE 

I 

jHERE 

I 

j BASEADDR 

I FIRST 



| LAST 

I 

l 



j Operation! Operand 
"ffifiER j"270- 



| USING 
|LM 
IB 
IDC 



END 



|HERE,2,3,4,5 

| 3, 5, BASEADDR 

| FIRST 

| A (HERE +4096, HERE+8 19 2, HERE+ 12288) 



BEGIN 



Figure 4. Multiple Base Register Assignment 
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RELATIVE ADDRESSING 



Relative addressing is the technique of 
addressing instructions and data areas by 
designating their location in relation to 
the location counter or to some symbolic 
location. This type of addressing is 
always in bytes, never in bits, words, or 
instructions. Thus, the expression *+4 
specifies an address that is four bytes 
greater than the current value of the 
location counter. in the sequence of 
instructions shown in the following 
example, the location of the CR machine 
instruction can be expressed in two ways, 
ALPHA+2 or BETA-4, because all of the 
mnemonics in the example are for 2 -byte 
instructions in the RR format. 

r t t 1 

| Name | Operation | Operand | 

|. + f 1 

| ALPHA |LR | 3, 4 J 

I |CR |4,6 | 

J |BCR J 1,14 | 

| BETA JAR | 2, 3 | 

I X X J 



Program Sectioning and Linking 



It is often convenient, or necessary, to 
write a large program in sections. The 
sections may be assembled separately, then 
combined subsequently into one program. 
The assembler provides facilities for 
creating multi sectioned programs and 
symbolically linking separately assembled 
programs or program sections. 

Sectioning a program is optional, and 
many programs can best be written without 
sectioning them. The programmer writing an 
unsectioned program need not concern 
himself with the subsequent discussion of 
program sections, which are called control 
sections. He need not employ the CSECT 
instruction, which is used to identify the 
control sections of a multisection program. 
Similarly, he need not concern himself with 
the discussion of symbolic linkages if his 
program neither requires a linkage to nor 
receives a linkage from another program. 
He may, however, wish to identify the 
program and/or specify a tentative starting 
location for it, both of which may be done 
by using the START instruction. He may 
also want to employ the dummy section 
feature obtained by using the DSECT 
instruction. 

Note; Program sectioning and linking is 
closely related to the specification of 
base registers for each control section. 
Sectioning and linking examples are 



provided under the heading "Addressing 
External Control Sections." 



CONTROL SECTIONS 



o 



The concept of program sectioning is a 
consideration at coding time, assembly 
time, and load time. To the programmer, a 
program is a logical unit. He may want to 
divide it into sections called control 
sections; if so, he writes it in such a way 
that control passes properly from one 
section to another regardless of the 
relative physical position of the sections 
in storage. A control section is a block 
of coding that can be relocated, 
independently of other coding, at load time 
without altering or impairing the operating 
logic of the program. It is normally 
identified by the CSECT instruction. 
However, if it is desired to specify a 
tentative starting location, the START 
instruction may be used to identify the 
first control section. 

To the assembler, there is no such thing 
as a program; instead, there is a source 
module, which consists of one or more 
control sections. (However, the terms 
source module and program are often used 
interchangeably.) An unsectioned program 
is treated as a single control section. To / X 
the linkage editor, there are no programs, \-Jr 
only control sections that must be 
fashioned into one or more phases. 

The output from the assembler is called 
an object module. It contains data 
required for linkage editor processing. 
The external symbol dictionary, which is 
part of the object module, contains 
information the linkage editor needs in 
order to complete cross-referencing between 
control sections, as it combines them into 
a program. The linkage editor can take 
control sections from various assemblies 
and combine them properly with the help of 
the corresponding external symbol 
dictionaries. Successful combination of 
separately assembled control sections 
depends on the techniques used to provide 
symbolic linkages between the control 
sections . 

Whether the programmer writes an 
unsectioned program, a multisection 
program, or part of a multisection program, 
he still knows what eventually will be 
entered into storage, because he has 
described storage symbolically. He may not 
know where each section appears in storage, 
but he does know what storage contains. 
There is no constant relationship between ^^^ 
control sections. Thus, knowing the T />, 

location of one control section does not 4 > 
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make another control section addressable by 
relative addressing techniques. 

There is a limit to the number of 
external symbol dictionary entries. The 
total number of control sections (named, 
unnamed, and common control sections) , 
dummy sections, unique symbols in EXTRN and 
WXTRN statements, and V-type address 
constants may not exceed 255. (The V-type 
address constant is described in Section 5 
under "DC — Define Constant"; the other 
external symbols are described in this 
section.) If the same symbol appears both 
in V-type address constant and in the name 
field of a START, CSECT, or DSECT 
statement, it is counted as two symbols. 



Control Section Location Assignment 



Control section contents can be intermixed 
because the assembler provides a location 
counter for each control section. Control 
sections are assigned starting locations 
consecutively, in the same order as the 
control sections first occur in the 
program. Each control section subsequent 
to the first begins at the next available 
double word boundary. 



FIRST CONTROL SECTION 



The first control section of a program has 
the following special properties. 

1« The initial value of its location 
counter may be specified as an 
absolute value. 

2. It normally contains the literals 
requested in the §ource module, 
although their positioning can be 
altered. This is further explained 
under the discussion of the LTORG 
assembler instruction. 



START — Start Assembly 



I T T 1 

| Name |Operation| Operand | 

j 4 + , 

| Any symbol {START |A self-defining | 
jor not used j j terra or not | 
I I I used | 

1 J A , I 

If a symbol names the START instruction, 
the symbol is established as the name of 
the control section. If not, the control 
section is considered to be unnamed. All 
subsequent statements are assembled as part 
of that control section. This continues 
until an instruction identifying a 
different control section is encountered. 
A CSECT instruction named by the same 
symbol that names a START instruction is 
considered to identify the continuation of 
the control section first identified by the 
START. Similarly, an unnamed CSECT that 
occurs in a program initiated by an unnamed 
START is considered to identify the 
continuation of the unnamed control 
section. 

The symbol in the name field is a valid 
relocatable symbol whose value represents 
the address of the first byte of the 
control section. It has a length attribute 
of one. 

The assembler uses the self-defining 
term specified by the operand as the 
initial value of the location counter of 
the program. This value should be 
divisible by eight. For example, either of 
the following statements: 

r t t 1 

(Name |Operationj Operand J 

j + 4 „ , 

JPR0G2 j START J2040 j 

JPR0G2 j START iX^Fe* j 

I -J J 1 

could be used to assign the name PR0G2 to 
the first control section and to set the 
initial value of the location counter to 
2040. If the operand is omitted, the 
assembler sets the initial value to zero. 
The location counter is set at the next 
doubleword boundary when the value of the 
START operand is not divisible by 8. 

Note : The START instruction may not be 
preceded by any type of assembler language 
statement that may either affect or depend 
upon the setting of the location counter. 






The START instruction may be used to give a 
name to the first (or only) control section 
of a source module. It may also be used to 
specify the initial value of the location 
counter for the first control section of 
the module. The typical form of the START 
instruction statement is as follows: 



CSECT — Identify Control Section 



The CSECT instruction identifies the 
beginning or the continuation of a control 
section. The typical form of the CSECT 
instruction statement is as follows: 
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r , T 1 

J Name | Ope rati on | Operand | 

j. f f i 

| Any symbol jCSECT (Not used; should | 
| or not used | jnot be present | 
l i. j. j 

If a symbol names the CSECT instruction, 
the symbol is established as the name of 
the control section; otherwise the section 
is considered to be unnamed. All 
statements following the CSECT are 
assembled as part of that control section 
until a statement identifying a different 
control section is encountered (i.e., 
another CSECT or a DSECT instruction) . 

The symbol in the name field is a valid 
relocatable symbol whose value represents 
the address of the first byte of the 
control section. It has a length attribute 
of one. 

Several CSECT statements with the same 
name may appear within a source module. 
The first is considered to identify the 
beginning of the control section; the rest 
identify the resumption of the section. 
Thus , statements from different control 
sections may be interspersed. They are 
properly assembled (assigned contiguous 
storage locations) as long as the 
statements from the various control 
sections are identified by the appropriate 
CSECT instructions. 

Under the Tape Operating System (TOS) a 
completely empty control section (CSECT) is 
flagged in error. 



Unnamed Control Section 



If neither a named CSECT instruction nor 
START instruction appears at the beginning 
of the program, the assembler determines 
that it is to assemble an unnamed control 
section as the first (or only) control 
section. There may be only one unnamed 
control section in a program. If one is 
initiated and is then followed by a named 
control section, any subsequent unnamed 
CSECT statements are considered to resume 
the unnamed control section. If it is 
desired to write a small program that is 
unsectioned, the program does not need to 
contain a CSECT instruction. 



DSECT — Identify Dummy Section 



A dummy section represents a control 
section that is assembled but is not part 
of the object program. A dummy section is 



a convenient means of describing the layout 
of an area of storage without actually 
reserving the storage. (It is assumed that 
the storage is reserved either by some 
other part of this assembly or else by 
another assembly.) The DSECT instruction 
identifies the beginning or resumption of a 
dummy section. More than one dummy section 
may be defined per assembly, but each nmst 
be named. The typical form of the DSECT 
instruction statement is as follows: 



I Name 



j. 

| An ordinary | DSECT 

j symbol or a | 

j variable j 

j symbol j 



■T T 

| Operation | Operand 



j Not used ; should 
jnot be present 



The symbol in the name field is a valid 
relocatable symbol whose value represents 
the first byte of the section. It has a 
length attribute of one. 

Program statements belonging to dummy 
sections may be interspersed throughout the 
program or may be written as a unit. In 
either case, the appropriate DSECT 
instruction should precede each set of 
statements. When multiple DSECt 
instructions with the same name are 
encountered, the first is considered to 
initiate the dummy section and the rest to 
continue it. 

Symbols that name statements in a dummy 
section may be used in USING instructions. 
Therefore, they may be used in program 
elements (e.g., machine instructions and 
data definitions) that specify storage 
addresses. An example illustrating the use 
of a dummy section appears subsequently 
under "Addressing Dummy Sections" in this, 
section. 

Note ; A symbol that names a statement in a 
dummy section may be used in an A- type 
address constant only if it is paired with 
another symbol (with the opposite sign) 
from the same dummy section. 

Dummy Section Location Assignment . A 
location counter is used to determine the 
relative locations of named program 
elements in a dummy section. The location 
counter is always set to zero at the 
beginning of the dummy section, and the 
location values assigned to symbols that 
name statements in the dummy section are 
relative to the initial statement in the 
section. 

Addressing Dummy Sections . The programmer 
may wish to describe the format of an area 
whose storage location will not be 
determined until the program is executed. 



O 



jT~ 



'<S 



4 ji 
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He can describe the format of the area in a 
dummy section, and he can use symbols 
defined in the dummy section as the 
operands of machine instructions. To 
effect references to the storage area, he 
does the following: 

1. Provides a. USING statement specifying 
both a general register that the 
assembler can assign to the machine 
instructions as a base register and a 
value from the dummy section that the 
assembler may assume the register 
contains. 

2- Ensures that the same register is 

loaded with the actual address of the 
storage area. 

The values assigned to symbols defined 
in a dummy section are relative to the 
initial statement of the section. 

Thus, all machine instructions which 
refer to names defined in the dummy section 
will , at execution time , refer to storage 
locations / relative to the address loaded 
into the register. 

An example is shown in the following 
coding. Assume that two independent 
modules (assembly 1 and assembly 2) have 
been loaded and are to be executed as a 
single overall program. Assembly 1 is an 
input routine that places a unit record in 
a specified area of storage, and places the 
address of that area in register 3 . The 
input area is aligned on a f ullword 
boundary. Then assembly 1 branches to 
assembly 2. Assembly 2 processes the 
record, which has the following format: 



Columns 

1 

2 

3 and 4 

5 through 8 



Content 

INCODE 

blank 

INPUTA 

INPUTB 






The coding shown in the example is from 
assembly 2. 

The input area is described in assembly 
2 by the DSECT control section named 
INAREA. portions of the input area (i.e., 
record) that the programmer wishes to work 
with are named in the DSECT control section 
as shown. The assembler instruction USING 
INAREA, 3 designates general register 3 as 
the base register to be used in addressing 
the DSECT control section, and that general 
register 3 is assumed to contain the 
address of INAREA. 

Assembly 1, during execution, loads the 
actual beginning address of the input area 
in general register 3. Because the symbols 
used in the DSECT section are defined 
relative to the initial statement in the 



section, the address values they represent, 
will, at the time of program execution, be 
the actual storage locations of the input 
area. 



r t t 

|Name |Operation| Operand 



JASMBLY2 


CSECT 




I BEGIN 


BALR 


2,0 




USING 

• 


*,2 




• 
USING 


INAREA., 3 




CLI 


JtNCODE\C , A , 




BE / 


atype;;] 


| ATYPE 


• / 
MVC J 


WORKA , INPUTA 




MVC/ 


WQ^KB , INPUTB 




'CNOP / 


2,4 


| WORK A/ 


DS X 


H 


| WORKS 


DS X 


F 


| INAREA^- 


DSECT 






CNOP 


0,4 


|IN£QDE^ 


'DS 


CL1 




DS 


CL1 


| INPUTA 


DS 


H 


| INPUTB 


DS 

• 

END 


F 


1 J. i 



The programmer must ensure that a 
section of code in his program is actually 
described by the dummy section which 
references it i.e., that data is properly 
aligned in both places. The DSECT named 
INAREA in the previous example adequately 
describes, the section of code introduced 
into assembly 1 , as it was aligned on a 
f ullword boundary. Further, WORKA and 
WORKB will be aligned and contiguous to 
each other in the same way as INPUTA and 
INPUTB are. 



COM — Define Blank Common Control Section 



The COM assembler instruction identifies 
and reserves a common area of storage that 
may be referred to by independent modules 
that have been linked and loaded for 
execution as one overall program. 

Only one blank common control section 
may be designated in a source module. 
However, more than one COM statement may 
appear within a module. The first 
identifies the beginning of the blank 
common control section; the rest identify 
the resumption of the section. 
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When several modules are loaded, each 
designating a common control section, the 
amount of storage reserved is equal to the 
longest common control section. The form 
is: 

r r 1 1 

| Name | Operation | Operand | 

j. f f 1 

| Sequence | COM |Not used; should | 
| symbol orj jnot be present j 
| not used | j | 

l jl x. . J 

The common area may be broken up into 
subfields through use of the DS and DC 
assembler instructions. Names of subfields 
are defined relative to the beginning of 
the common section, as in the DSECT control 
section. 

It is necessary to establish 
addressability relative to a named 
statement within COM since the COM 
statement itself cannot have a name. In 
the following example, addressability to 
the common area of storage is established 
relative to the named statement XYZ. 



r t 1 

| Name | Operation | Operand 
j. + f 





1 * 


1 




1 * 

1 L 
| USING 
|MVC 
1 • 


|8,=A(XYZ) 

j XYZ , 8 

JPDQ (16) ^UC'ABCD 1 


|XYZ 
JPDQ 


1 * 
j COM 
|DS 
|DS 

1 • 
1 * 


| 16F 
j 16C 



No instructions or constants appearing 
in a common control section are assembled. 
Data can only be placed in a common control 
section through execution of the program. 

If the assignment of common storage is 
done in the same manner by each independent 
assembly, reference to a location in the 
common area by any assembly results in the 
same location being referenced. When the 
blank common control section is assembled 
the initial value of the location counter 
is set to zero. 



assembled program sections. The linkages 
can be effected only if the assembler is 
able to provide information about the 
linkage symbols to the linkage editor, 
which resolves these linkage references. 
The assembler places the necessary 
information in the external symbol 
dictionary on the basis of the linkage 
symbols identified by, e.g., the ENTRY and 
EXTRN instructions. Note that these 
symbolic linkages are described as linkages 
between independent modules; more 
specifically, they are linkages between 
independently assembled control sections. 

In the module where the linkage symbol 
is defined (i.e., used as a name) , it must 
also be identified to the linkage editor 
and assembler by means of the ENTRY 
assembler instruction (unless the symbol is 
the name of a CSECT or START statement) . 
It is identified as a symbol that names an 
entry point, which means that another 
module may use that symbol in order to 
effect a branch operation or a data 
reference. The assembler places this 
information in the external symbol 
dictionary. 

Similarly, the module that uses a symbol 
defined in some other module must identify 
it by the EXTRN or WXTRN assembler 
instruction. Since the definition of the 
symbol appears in another module, the 
assembler arbitrarily assigns a length 
attribute of 1 and a value of 0. The 
assembler places this information in the 
external symbol dictionary. 

Another way to obtain symbolic linkages 
is by using the V-type address constant. 
The subsection "Data Definition 
Instructions" in Section 5 contains the 
details pertinent to writing a V-type 
address constant. It is sufficient here to 
note that this constant may be considered 
an indirect linkage point. It is created 
from an externally defined symbol, but that 
symbol does not have to be identified by an 
EXTRN or WXTRN statement. The V-type 
address constant is intended to be used 
for external branch references (i.e., for 
effecting branches to other programs) . 
Therefore, it should not be used for 
external data references (i.e., for 
referring to data in other modules) . 






f 






ENTRY — Identify Entry Point Symbol 



SYMBOLIC LINKAGES 



Symbols may be defined in one module and 
referred to in another, thus effecting 
symbolic linkages between independently 



The ENTRY instruction identifies linkage 
symbols that are defined in the module 
where the ENTRY instruction appears. These 
symbols can be referred to in other 
modules . 
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I Name 



■T T 

| Operation | Operand 



I) 



o 



j. + a ^ 

[Sequence | ENTRY |One or more reloca- 
| symbol or J | table symbol s , 
| not used | | separated by 

j commas, that also 
| appear as state- 
jment names 

L A A J 

A source module may contain a maximum of 
100 ENTRY symbols. ENTRY- symbols which are 
not defined (not appearing as statement 
names) , although invalid, will also count 
towards this maximum. 

An ENTRY statement operand may hot 
contain a symbol defined in a dummy section 
or in a blank common control section. An 
ENTRY statement containing a symbol defined 
in an unnamed control section can be 
processed by the assembler, but the DOS/TOS 
Linkage Editor will not process the 
resulting deck. The following example 
identifies the statements named SINE and 
COSINE as entry points to the program. 

r t t 1 

| Name | Operation | Operand J 

,. A A 4 

I j ENTRY | SINE, COSINE j 

l A A J 



Note : Labels of START and CSECT statements 
are automatically treated as entry points 
to a module. Thus they need not be 
identified by ENTRY statements. 



EXTRN — Identify External Symbol 



The EXTRN instruction identifies linkage 
symbols used by one source module but 
identified in another module. Each 
external symbol must be identified. This 
includes symbols that refer to control 
section names. The format of the EXTRN 
statement is: 



j Name j Operation j Operand j 

j Sequence j EXTRN j One or more relocata- 1 
| symbol orj jble symbols, separ- j 
| not used | jated by commas. j 
i : a a j 

The symbols in the operand field may not 
appear as names of statements in the 
module. The following example identifies 
three external symbols that have been used 
as operands in the module but are 
identified in some other module. 



r t t 1 

j Name | Operation | Operand | 

y a a ;, 

j j EXTRN |RATEBL,PAYCALC j 

j j EXTRN jWITHCALC j 

L A L J 

An example that employs the EXTRN 
instruction appears subsequently under 
"Addressing External Control Sections." 

Note 1 : A V-type address constant does not 
have to be identified by an EXTRN 
statement. 

Note 2 : Only one external symbol may be 
used in an expression. 



Addressing External Control Sections 



A common way for a program to link to an 
external control section is to: 

1 . Create a V-type address constant with 
the name of the external symbol. 

2. Load the constant into a general 
register and branch to the control 
section via the register. 



I Name 



\- 



"T T 

| Operation | Operand 



|MAINPROG| CSECT 
| BEGIN |BALR 
| | USING 
I I- 


I 
|2,0 

I*. 2 
I 


I IL 

| | BALR 

I I* 


I 

|3,VC0N 
!1,3 
I 


I I* 
JVCON | DC 
| | END 


I 

| V (SINE) 

j BEGIN 



The combined number of control sections 
and dummy sections plus the number of 
unique symbols in EXTRN or WXTRN statements 
and V-type address constants may not exceed 
255. (EXTRN and WXTRN statements are 
discussed in this section; V-type constants 
in Section 5 under "DC — Define Constant.") 
If the same symbol appears in a V-type 
address constant and in the name entry of a 
CSECT or DSECT statement, it is counted as 
two symbols. 

For example, to link to the control 
section named SINE, the preceding coding 
might be used. 

An 'external symbol naming data may be 
referred to as follows: 
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Identify the external symbol with the 
EXTRN instruction, and create an 
address constant from the symbol. 



Load the constant into a general 
register, and use the register for 
base addressing. 



For example, to use an area named 
RATETBL, which is in another control 
section, the following coding might be 
used: 



r t t 1 

J Name | Operation | Operand | 

j. x x .j 

IMAINPROGJCSECT 
BEGIN | BALR j 2 , 
USING |*,2 



WXTRN — Identify Weak External Symbol 



(DOS Assembler 14K D only) 



The WXTRN statement has the same format and 
almost the same use as the EXTRN statement. 
The only difference is that WXTRN 
suppresses the AUTOLINK function of the 
linkage editor for the symbols identified 
by it. Its format is: 



r t t n 

| Name | Operation} Operand J 

j. x + ,j 

| Sequence | WXTRN |One or more relocat- | 
| symbol orj (able symbols, separ- j 
| not used | jated by commas. j 

l X J. .- J 



O 



EXTRN 



| USING 
IA 



I* 

| RATEADDR | DC 
END 
-X 



I RATETBL 



4 , RATEADDR 
RATETBL, 4 
3 ,RATETBL 



| A (RATETBL) 
I BEGIN 



l 4. X J 



The AUTOLINK (automatic library look-up) 
function searches the relocatable library 
for any unresolved external references. If 
it finds the external reference, it 
includes the module where the reference 
appears in the phase produced by the 
linkage editor. Any address constant 
containing an unresolved weak external 
symbol will appear (at program execution 
time) as though the value of the symbol was 
resolved to zero. 



Z, 



Fcr more detailed information on 
AUTOLINK refer to DOS System Control and 
Service . 



c> 



Note : AUTOLINK will be suppressed for a 
symbol defined both in a V-type address 
constant and in a WXTRN statement. 
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Section 4. Machine Instructions 



O 



This section discusses the coding of the 
machine instructions represented in the 
assembler language. The reader is reminded 
that the functions of each machine 
instruction are discussed in the 
"Principles of Operation" manual (see 
"Preface") . 



Machine Instruction Statements 



Machine instructions may be represented 
symbolically as assembler language 
statements. The symbolic format of each 
varies according to the actual machine 
instruction format, of which there are 
five: RR, RX, RS, SI, and SS. Within each 
basic format, further variations are 
possible. 

The symbolic format of a machine 
instruction is similar to, but does not 
duplicate, its actual format. Appendix C 
illustrates machine format for the five 
classes of instructions. A mnemonic 
operation code is written in the operation 
field, and one or more operands are written 
in the operand field. Comments may be 
appended to a machine instruction statement 
as previously explained in Section 1 . 

Any machine instruction statement may be 
named by a symbol, which other assembler 
statements can use as an operand. The 
value attribute of the symbol is the 
address of the leftmost byte assigned to 
the assembled instruction. The length 
attribute of the symbol depends on the 
basic instruction format, as follows: 



Basic Format 


Lenqth Attribute 


RR 


2 


RX 


4 


RS 


a 


SI 


4 


SS 


6 



© 



INSTRUCTION ALIGNMENT AND CHECKING 



All machine instructions are aligned 
automatically by the assembler on halfword 
boundaries. If any statement that causes 
information to be assembled requires 
alignment, the bytes skipped are filled 
with hexadecimal zeros. All expressions 
that specify storage addresses are checked 
to insure that they refer to appropriate 



boundaries for the instructions in which 
they are used. Register numbers are also 
checked to make sure that they specify the 
proper registers, as follows: 

1 . Floating-point instructions must 
specify floating-point registers 0,2, 
4, or 6. 

2. Double- shift, fullword multiply, and 
divide instructions must specify an 
even-numbered general register in the 
first operand. 

3. Extended precision floating-point 
instructions must specify floating 
point register or 4. 



OPERAND FIELDS AND SUBFIELDS 



Some symbolic operands are written as a 
single field and other operands are written 
as a field followed by one or two --- 
subfields. For example, addresses consist 
of the contents of a base register and a 
displacement. An operand that specifies a 
base and displacement is written as a 
displacement field followed by a base 
register subfield, as follows: 40(5). In 
the RX format, both an index register 
subfield and a base register subfield are 
written as follows: 40(3,5) . In the SS 
format, both a length subfield and a base 
register subfield are written as follows: 
40 (21,5) . 

Appendix C shows two types of addressing 
formats for RX, RS, SI, and SS 
instructions. In each case, the first type 
shows the method of specifying an address 
explicitly, as a base register and 
displacement. The second type indicates 
how to specify an implied address as an 
expression. 

For example, a load multiple instruction 
(RS format) may have either of the 
following symbolic operands: 

R1,R3,D2 (B2) — explicit address 
R1,R3,S2 — implied address 

Whereas D2 and B2 must be represented by 
absolute expressions, S2 may be represented 
either by a relocatable or an absolute 
expression. 

In order to use implied addresses, the 
following rules must be observed: 
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2. 



The base register assembler 
instructions (USING and DROP) must be 
used. 

An explicit base register designation 
must not accompany the implied 
address . 



of two subfields that are separated by a 
comma and enclosed by parentheses, the 
following rules apply: 

1. If both subfields are omitted, the 
separating comma and the parentheses 
must also be omitted. 



o 



For example, assume that FIELD is a 
relocatable symbol, which has been assigned 
a value of 7400. Assume also that the 
assembler has been notified (by a USING 
instruction) that general register 12 
currently contains a relocatable value of 
4096 and is available as a base register. 
The following example shows a machine 
instruction statement as it would be 
written in assembler language and as it 
would be assembled. Note that the value of 
D2 is the difference between 7400 and 4096 
and that X2 is assembled as zero, since it 
was omitted. The assembled instruction is 
presented in hexadecimal: 

Assembler statement: 

ST 4, FIELD 

Assembled instruction: 



2,48(4,5) 
2, FIELD 



(implied address) 



Op. Code R1 
50 4 



X2 




B2 
C 



D2 
CE8 



An address may be specified explicitly 
as a base register and displacement (and 
index register for RX instructions) by the 
formats shown in the first column of Figure 
5. The address may be specified as an 
implied address by the formats shown in the 
second column. Observe that the two 
storage addresses required by the SS 
instructions are presented separately; an 
implied address may be used for one while 
an explicit address is used for the other. 

r 1 1 -s 

jType JExplicit Add re ss| Implied Address | 

K- f f i 



|RX 

I 

|RS 
| SI 
ISS 



|D2(X2,B2) 

|D2(,B2) 

|D2(B2) 

|D1 (B1) 

|D1 ( L 1,B1) 

|D1(L,B1) 

|D2(L2,B2) 



S2 (X2) 
|S2 
|S2 
|S1 

|S1 (L1) 
|S1(L) 
I S2 (L2) 



Figure 5. Details of Address Specification 



A comma must be written to separate 
operands. Parentheses must be written to 
enclose a subfield or subfields, and a 
comma must be written to separate two 
subfields within parentheses. When 
parentheses are used to enclose one 
subfield, and the subfield is omitted, the 
parentheses must be omitted. In the case 



2. If the first subfield in the sequence 
is omitted, the comma that separates 
it from the second subfield is 
written. The parentheses must also be 
written. 

MVC 32(16,5) ,FIELD2 

MVC 32 (,5) ,FIELD2 (implied length) 

3. If the second subfield in the sequence 
is omitted, the comma that separates 
it from the first subfield must be 
omitted. The parentheses must be 
written. 

MVC 32 (16,5) ,FIELD2 
MVC FIELD 1 (16) ,FIELD2 
(implied address) 

Fields and subfields in a symbolic 
operand may be represented either by 
absolute or by relocatable expressions, 
depending on what the field requires. (An 
expression has been defined as consisting 
of one term or a series of arithmetically 
combined terms.) Refer to Appendix C for a 
detailed description of field requirements. 

Note : Blanks may not appear in an operand 
unless provided by a character 
self- defining term or a character literal. 
Thus, blanks may not intervene between 
fields and the comma separators, between 
parentheses and fields, etc. 



LENGTHS— EXPLICIT AND IMPLIED 



The length field in SS instructions can 
be explicit or implied. To imply a lengtn, 
the programmer omits a length field from 
the operand. The omission indicates that 
the length field is either of the 
following: 

1 . The length attribute of the expression 
specifying the displacement, if an 
explicit base and displacement have 
been written. 

2. The length attribute of the expression 
specifying the effective address, if 
the base and displacement have been 
implied. 



~\ 



\A w 



r~\ t 
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^hlktt^ 



^^jj0T 



In either case, the length attribute for 
an expression is the length of the leftmost 
term in the expression. The length 
attribute of asterisk (*) is equal to the 
length of the instruction in which it 
appears, except that in an EQU to * 
statement, the length attribute is 1. 

By contrast, an explicit length is 
written by the programmer in the operand as 
an absolute expression. The explicit 
length overrides any implied length. 

Whether the length is explicit or 
implied, it is always an effective length. 
The value inserted into the length field of 
the assembled instruction is one less than 
the effective length in the machine 
instruction statement. 

Note : If a length field of zero is 
desired, the length may be stated as zero 
or one. 

To summarize, the length required in an 
SS instruction may be specified explicitly 
by the formats shown in the first column of 
Figure 6 or may be implied by the formats 
shown in the second column. Observe that 
the two lengths required in one of the SS 
instruction formats are presented 
separately. An implied length may be used 
for one while an explicit length is used 
for the other. 



} Explicit Length j Implied Length 
|. f 



|D1 (L1,B1) 


D1 (,B1) 


|S1(L1) 


S1 


|D1 (L,Bt> 


D1 (,B1) 


|S1(L) 


S1 


|D2(L2,B2) 


D2 (,B2) 


|S2(L2) 


S2 


L 






Figure 6. Details of Length Specification 
in SS Instructions 



Machine Instruction Mnemonic Codes 



represents Move. The function may be 
further defined by a modifier. For 
example, the modifier L indicates a logical 
function, as in AL for Add Logical and MV 
is modified by C (MVC) to indicate Move 
Characters. 

Mnemonic codes for functions involving 
data usually indicate the data types , by 
letters that correspond to those for the 
data types in the DC assembler instruction 
(see Section 5) . Furthermore, letters U, 
W, and X have been added to indicate short 
unnorma li zed , long unnormalized, and 
extended floating point operations, 
respectively. For example, AE indicates 
Add Normalized Short, whereas AU indicates 
Add Unnormalized Short. Where applicable, 
fullword fixed-point data is implied if the 
data type is omitted. 

The letters R and I are added to the 
codes to indicate, respectively, RR and SI 
machine instruction formats. Thus , AER 
indicates Add Normalized Short in the RR 
format. Functions involving character and 
decimal data types imply the SS format. 



MACHINE INSTRUCTION EXAMPLES 



The examples that follow are grouped 
according to machine instruction format. 
They illustrate the various symbolic 
operand formats. All symbols employed in 
the examples must be assumed to be defined 
e±sewhere in the same assembly. All 
symbols that specify register numbers and 
lengths must be assumed to be equated 
elsewhere to absolute values. 

Implied addressing, control section 
addressing, and the function of the USING 
assembler instruction are not considered 
here. For discussion of these 
considerations and for examples of coding 
sequences that illustrate them, refer to 
"Program Sectioning and Linking", and "Base 
Register Instructions" in Section 3. 






The mnemonic operation codes (shown in 
Appendix D) are designed to be easily 
remembered codes that indicate the 
functions of the instructions. The normal 
format of the code is shown below; the 
items in brackets are not necessarily 
present in ail codes: 

Verb [Modifier] [Data Type] [Machine Format] 

The verb, which is usually one or two 
characters, specifies the function. For 
example, A represents Add, and MV 



RR Format 



r t t 

j Name J Ope ra ti on ] Ope rand 
j. + 4 

j ALPHA 1 |LR 1 1,2 
JALPHA2 |LR |REG1,REG2 
j BETA |SPM j 15 
JGAMMA1 | SVC j 250 
JGAMMA2 j SVC |TEN 
l L J 
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The operands of ALPHA1 , BETA, and GAMMA 1 
are decimal self-defining values, which are 
categorized as absolute expressions. The 
operands of ALPHA2 and GAMWA2 are symbols 
that are equated elsewhere to absolute 
values. 



SI Format 



RX Format 




r " t — ■" 


T ~"~ 


|Name j Operation 
I j 


J Operand 


j ALPHA 1 |L 


| 1,39 (4,10) 


JALPHA2 |L 


J REG 1,39 (4, TEN) 


|BETA1 |L 


| 2 , ZETA (4) 


| BETA2 | L 


|REG2,ZETA (REG 4) 


JGAMMA1 |L 


| 2 , ZETA 


|GAMMA2 |L 


| REG2 , ZETA 


|GAMMA3 |L 


|2,=F' 1000' 


|LAMBDA1|L 


|3,20 (,5) 



Both ALPHA instructions specify explicit 
addresses; REG1 and TEN are absolute 
symbols. Both BETA instructions specify 
implied addresses, and both use index 
registers. Indexing is omitted from the 
GAMMA instructions. GAMMA 1 and GAMMA 2 
specify implied addresses. The second 
operand of GAMMA3 is a literal. LAMBDA 1 
specifies no indexing. 



r t t 

J Name | Oper at ion | Operand 



j. i + 

JALPHA1 JCLI |40(9),X , 40* 

JALPHA2 |CLI J40 (REG9) ,TEN 

JEETA1 JCLI | ZETA, TEN 

|BEQ;A2 JCLI JZETA^'A* 

| GAMMA 1 JSIO 1 40 (9) 

JGAWMA2 | SIC 1 0(9) 

JGAMMA3 JSIO |40(0) 

JGAMMA4 JSIO | ZETA 

L L J. _ J 

Ihe ALPHA instructions and GANMA1-GAMMA3 
specify explicit addresses, whereas the 
EEIA instructions and GAJWA4 specify 
implied addresses. GAKMA2 specifies a 
displacement of zero. GANMA3 does not 
specify a base register. 



SS Format 



RS Format 



{Name 
F 

| ALPHA 1 
| ALPHA2 
JALPHA3 
JALPHA4 
| BETA 
j GAMMA 1 
| GAMMA 2 
| GAMMA 3 
| GAMMA 4 

L 



"T T 

J Operation | Operand 



JAP |40 (9,8) ,30 (6,7) 

|AP J40 (NINE,REG8) ,30 (L6,7) 

JAP JFIELD2, FIELD 1 

JAP JFIELD2 (9) ,FIELD1 (6) 

JAP JFIELD2 (9) , FIELD 1 

JMVC J40(9,8) ,30 (7) 

JMVC J40 (NINE,PEG8) ,DEC (7) 

JMVC JFIELD2, FIELD 1 

JMVC JFIELD2 (9) , FIELD 1 



o 






r t r 

JName |OperationJ Operand 

j. + f 

JALPHA1 |BXH j 1,2,20 (14) 

|BXH JREG1,REG2,20 (REGD) 
JBXH | REG 1, REG 2, ZETA 
|SLL |REG2,15 
|SLL |REG2,0(15) 
.4. J. 



j ALPHA 2 
| ALPHA 3 
JALPHA4 
J ALPHAS 
L 



Whereas ALPHA1 and ALPHA2 specify 
explicit addresses, ALPHA3 specifies an 
implied address. ALPHA4 is a shift 
instruction shifting the contents of REG2 
left 15 bit positions. ALPHA5 is a shift 
instruction shifting the contents of REG2 
left by the value contained in general 
register 15. 



ALPHA 1, ALPHA2, GANMA1, and GAMMA2 
specify explicit lengths and addresses. 
ALPHA3 and GAMWA3 specify both implied 
length and implied addresses. ALPHA4 and 
GAMMA4 specify explicit length and implied 
addresses. BETA specifies an explicit 
length for FIELD2 and an implied length for 
FIELD 1; both addresses are implied. 



Extended Mnemonic Codes 



For the convenience of the programmer, the 
assembler provides extended mnemonic codes, 
which allow conditional branches to be 
specified mnemonically as well as through 
the use of the BC machine instruction. 
These extended mnemonic codes specify both 
the machine branch instruction and the 
condition on which the branch is to occur. 
The codes are not part of the universal set 
of machine instructions, but are translated 
by the assembler into the corresponding 
operation and condition combinations. 
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o 



Extended Code 



BR 

NOP 

NOPR 



BH 

BL 

BE 

BNH 

BNL 

BNE 



BO 

BP 

BM 

BZ 

BNP 

BNM 

BNZ 



BO 
BM 
BZ 
BNO 



D2 (X2 / B2) 
R2 

D2(X2,B2) 
R2 



Meaning 

Branch Unconditional 

Branch Unconditional (RR format) 

No Operation 

No Operation (RR format) 



Used After Compare Instructions 

D2(X2,B2) Branch on High 

D2(X2,B2) Branch on Low 

D2(X2,B2) Branch on Equal 

D2(X2,B2) Branch on Not High 

D2(X2,B2) Branch on Not Low 

D2(X2,B2) Branch on Not Equal 

Used After Arithmetic Instructions 

D2(X2,B2) Branch on Overflow 

D2(X2,B2) Branch on Plus 

D2(X2,B2) Branch on Minus 

D2(X2,B2) Branch on Zero 

D2(X2,B2) Branch on Not Plus 

D2(X2,B2) Branch on Not Minus 

D2(X2,B2) Branch on Not Zero 

Used After Test Under Mask Instructions 



D2(X2,B2) 
D2 (X2,B2) 
D2(X2 f B2) 
D2 (X2,B2) 



Branch if Ones 
Branch if Mixed 
Branch if Zeros 
Branch if Not Ones 



Machine Instruction 

BC 1 5 , D2 (X2 , B2) 
BCR 15, R2 
BC 0,D2 (X2,B2) 
BCR 0,R2 



BC 2 , D2 (X2 , B2) 
BC 4,D2 (X2 r B2) 
BC 8,D2 (X2,B2) 
BC 13,D2(X2,B2) 
BC 1 1 , D2 (X2 , B2) 
BC 7,D2 (X2,B2) 



BC 1 ,D2 (X2,B2) 
BC 2,D2 (X2,B2) 
BC 4,D2 (X2,B2) 
BC 8,D2 (X2,B2) 
BC 13,D2(X2,B2) 
BC 11,D2(X2,B2) 
BC 7,D2 (X2,B2) 



BC 1,D2(X2,B2) 
BC 4,D2 (X2,B2) 
BC 8,D2 (X2,B2) 
BC 1 4 , D2 (X2 , E2) 



Figure 7. Extended Mnemonic Codes 



The allowable extended mnemonic codes 
and their operand formats are shown in 
Figure 7, together with their machine 
instruction equivalents. Unless otherwise 
noted, all extended mnemonics shown are for 
instructions in the RX format. Note that 
the only difference between the operand 
fields of the extended mnemonics and those 
of their machine instruction equivalents is 
the absence of the R1 field and the comma 
that separates it from the rest of the 
operand field. The extended mnemonic list, 
like the machine instruction list, shows 
explicit address formats only. Each 
address can also be specified as an implied 
address. 



In the following examples, which 
illustrate the use of extended mnemonics, 
it is to be assumed that the symbol GO is 
defined elsewhere in the program. 



■ 1 



r t t " 1 

jName |Operation| Operand | 

j. + + 1 

|B |40(3,6) 

|B |*0(,6) 

|BL | GO (3) 

|BL |G0 

| BR 1 4 

| NOP | GO (3) 

L I JL 



The first two instructions specify an 
unconditional branch to an explicit 
address. The address in the first case is 
the sum of the contents of base register 6, 
the contents of index register 3, and the 
displacement 40; the address in the second 
instruction is not indexed. The third 
instruction specifies a branch on low to 
the address implied by GO as indexed by the 
contents of index register 3; the fourth 
instruction does not specify an index 
register. The next instruction is an 
unconditional branch to the address 
contained in register 4. The last 
instruction is a "no operation". It will 
not branch under any condition because the 
mask field is zero. 
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Section 5. Assembler Instruction Statements 






Just as machine instructions are used to 
request the computer to perform a sequence 
of operations during program execution 
time, so assembler instructions are 
requests to the assembler to perform 
certain operations during the assembly. 
Assembler instruction statements, in 
contrast to machine instruction statements, 
do not always cause machine instructions to 
be included in the assembled program. 
Some, such as DS and DC, generate no 
instructions but do cause storage areas tc 
be set aside for constants and other data. 
Others, such as EQU and SPACE, are 
effective only at assembly time; they 
generate nothing in the assembled program 
and have no effect on the location counter. 

The following is a list of all the 
assembler instructions. 

Symbol Definition Instruction 
EQU Equate Symbol 

D ata Definition Instructions 

DC Define Constant 

DS Define Storage 

CCW Define Channel Command Word 

P rogram Sectioning and linking Instructions 1 
START Start Assembly 
CSECT Identify Control Section 
DSECT Identify Dummy Section 
ENTRY Identify Entry-Point Symbol 
EXTRN Identify External Symbol 
WXTRN Identify Weak External Symbol 
COM Identify Blank Common Control 
Section 

Ease Register Instructions 1 
USING Use Base Address Register 
DROP Drop Ease Address Register 

Listing Control Instructions 
TITLE Identify Assembly Output 
EJECT Start New Page 
SPACE Space Listing 
PRINT Print Optional Data 

Program Control Instructions 

ICTL~ Input Format Control 

ISEQ Input Sequence Checking 

ORG Set Location Counter 

LTORG Eegin Literal Pool 

CNOP Conditional No Operation 

COPY Copy Predefined Source Coding 

END End Assembly 

PUNCH Punch a Card 

REPRO Reproduce Following Card 



Discussed in Section 3. 



Symbol Definition Instruction 



EQU— EQUATE SYMBOL 



The EQU instruction is used to define a 
symbol by assigning to it the length, 
value, and relocatability attributes of an 
expression in the operand field. The 
typical form of the EQU instruction 
statement is as follows: 

r t t 1 

| Name (Operation | Operand | 

j. 4 + 1 

| A variable |EQU |An expression | 

j symbol or j j | 

j an ordinary j j j 

| symbol j j | 

l L J. J 

The expression in the operand field may 
be absolute or relocatable. Any symbols 
appearing in the expression must be 
previously defined. 

The symbol in the name field is given 
the same attributes as the expression in 
the operand field. The length attribute of 
the symbol is that of the leftmost (or 
only) term of the expression. When that 
term is * or a self-defining term, the 
length attribute is 1. The value attribute 
of the symbol is the value of the 
expression. 

The EQU instruction is the means of 
equating symbols to register numbers, 
immediate data, and other arbitrary values. 
The following examples illustrate how this 
might be done: 

r t t 1 

| Name (Operation J Operand | 

|. i + < 

JREG2 (EQU J 2 (general register) j 
(TEST |EQU | X"3F § (immediate data) j 

i .—J. j. „_j 

To reduce programming time, the 
programmer can equate symbols to frequently 
used expressions and then use the symbols 
as operands in place of the expressions. 
Thus, in the statement FIELD is 



I T T " 1 

(Name (Operation (Operand ( 

f — 4 + _ .j 

I I I I 

(FIELD (EQU (ALPHA- BETA +GAEM A j 

L I „ ! J 
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defined as ALP HA- BET A+ GAMMA and may be used 
in place of it. Note, however, that ALPHA, 
BETA, and GAMMA must all be previously 
defined. If the final result of the 
expression is negative, the low order 24 
bits of the 2's complement is used. 



Data Definition Instructions 



There are three data definition instruction 
statements: Define Constant (DC) , Define 
Storage (DS) , and Define Channel Command 
Word (CCW) . 

These statements are used to enter data 
constants into storage, to define and 
reserve areas of storage, and to specify 
the contents of channel command words. The 
statements may be named by symbols so that 
other program statements can refer to the 
fields generated from them. The discussion 
of the DC instruction is far more extensive 
than that of the DS instruction, because 
the DS instruction is written in the same 
format as the DC instruction and may 
specify some or all of the information that 
the DC instruction provides. Only the 
function and treatment of the statements 
vary. For this reason, the DC instruction 
is presented first and discussed in more 
detail than the DS instruction. 



DC—DEFINE CONSTANT 



The DC instruction is used to provide 
constant data in storage. It may specify 
one constant or a series of constants, 
thereby relieving the programmer of the 
necessity to write a separate data 
definition statement for each constant 
desired. Furthermore, a variety of 
constants may be specified: fixed-point, 
floating-point, decimal, hexadecimal, 
character, and storage addresses. (Data 
constants are generally called constants 
unless they are created from storage 
addresses, in which case they are called 
address constants.) The typical form of 
the DC instruction statement is as follows: 



Each operand consists of four subfields; 
the first three describe the constant, and 
the fourth subfield provides the constant 
or constants. The first and third 
subfields may be omitted, but the second 
and fourth must be specified. Note that 
more than one constant may be specified in 
the fourth subfield for most types of 
constants. Each constant so specified must 
be of the same type; the descriptive 
subfields that precede the constants apply 
to all of them. No blanks may occur within 
any of the subfields (unless provided as 
characters in a character constant or a 
character self-defining term) , nor may they 
occur between the subfields of an operand. 
Similarly, blanks may not occur between 
operands and the commas that separate them 
when multiple operands are being specified. 



The subfields of the DC operand are 
written in the following sequence: 

r 1 

j Subfield j 

| 1 2 3 4 | 

|. T T T .| 

|Dupli- | Type jModifiers | Constant (s) | 
j cation | j j I 

| Factor III | 

i i i j. j 

The symbol that names the DC instruction 
is the name of the constant (or first 
constant if the instruction specifies more 
than one) . Relative addressing (e.g., 
SYMBOL+2) may be used to address the 
various constants if more than one has been 
specified, because the number of bytes 
allocated to each constant can be 
determined. 

The value attribute of the symbol naming 
the DC instruction is the address of the 
leftmost byte (after any necessary 
alignment) of the first, or only, constant. 
The length attribute depends on two things: 
the type of constant being defined and the 
presence of a length specification. 
Implied lengths are assumed for the various 
constant types in the absence of a length 
specification. If more than one constant 
is defined, the length attribute is the 
length in bytes (specified or implied) of 
the first constant. 



o 



| Name 

j. f f .| 

| Any symbol 
or not used 



T " r T 1 

| Operation | Operand 
f f- 

DC | One operand (D as - 1 
j sembler) or one or 
| more operands (F 
j assembler) in the 
j format described 
j below, each separ-J 
j a ted by a comma. 
l j i j 



Boundary alignment also varies according 
to the type of constant being specified and 
the presence of a length specification. 
Some constant types are only aligned to a 
byte boundary, but the DS instruction can 
be used to force any type of word boundary 
alignment for them. This is explained 
under "DS — Define Storage." Other 
constants are aligned at various word 
boundaries (half, full, or double) in the 
absence of a length specification. If 
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length is specified, no boundary alignment 
occurs for such constants. 

Bytes that must be skipped in order to 
align the field at the proper boundary are 
not considered to be part of the constant. 
In other words, the location counter is 
incremented to reflect the proper boundary 
(if any incrementing is necessary) before 
the address value is established. Thus, 
the symbol naming the constant will not 
receive a value attribute that is the 
location of a skipped byte. 

Any bytes skipped in aligning statements 
that do not cause information to be 
assembled are not zeroed. Thus bytes 
skipped to align a DC statement are zeroed, 
and bytes skipped to align a DS statement 
are not zeroed. 



Note that a duplication factor of zero 
is permitted except in a literal and 
achieves the same result as it would in a 
DS instruction. A DC instruction with a 
zero duplication factor will not produce 
control dictionary entries. See "Forcing 
Alignment" under "DS — Define Storage." 

Note : If duplication is specified for an 
address constant containing a location 
counter reference, the value of the 
location counter used in each duplication 
is incremented by the length of the 
operand. 



Operand Subfield 2: Type 



O 



Appendix F summarizes, in chart form, 
the information concerning constants that 
is presented in this section. 

LITERAL DEFINITIONS ; The reader is 
reminded that the discussion of literals as 
machine instruction operands (in Section 2) 
referred him to the description of the DC 
operand for the method of writing a literal 
operand. All subsequent operand 
specifications are applicable to writing 
literals, the only differences being: 

1. The literal is preceded by an = sign. 

2. Unsigned decimal values must be used 
to express the duplication factor and 
length modifier values. 

3. The duplication factor may not be 
zero. 

4. S-type address constants may not be 
specified. 

5. Signed or unsigned decimal values must 
be used for exponent and scale 
modifier values. 

Examples of literals appear throughout 
the balance of the DC instruction 
discussion. 



Operand Subfield 1: Duplication Factor 



The duplication factor may be omitted. If 
specified, it causes the constant (s) to be 
generated the number of times indicated by 
the factor. The factor may be specified 
either by an unsigned decimal self-defining 
term or by a positive absolute expression 
that is enclosed by parentheses. The 
duplication factor is applied after the 
constant is assembled. All symbols in the 
expression must be previously defined. 



The type subfield defines the type of 
constant being specified. From the type 
specification, the assembler determines how 
it is to interpret the constant and 
translate it into the appropriate machine 
format. The type is specified by a single 
letter code as shown in Figure 8. 

Further information about these 
constants is provided in the discussion of 
the constants themselves under "Operand 
Subfield 4: Constant." 



Operand Subfield 3: Modifiers 



Modifiers describe the length in bytes 
desired for a constant (in contrast to an 
implied length) , and the scaling and 
exponent for the constant. If multiple 
modifiers are written, they must appear in 
this sequence: length s scale, exponent. 
Each is written and used as described in 
the following text. 



LENGTH MODIFIER : This is written as Ln, 
where n is either an unsigned decimal 
self -defining term or a positive absolute 
expression enclosed by parentheses. Any 
symbols in the expression must be 
previously defined. The value of n 
represents the number of bytes of storage 
that are assembled for the constant. The 
maximuM value permitted for the length 
modifiers supplied for the various types of 
constants is summarized in Appendix F. 
This table also indicates the implied 
length for each type of constant; the 
implied length is used unless a length 
modifier is present. A length modifier may 
be specified for any type of constant. 
However, no boundary alignment will be 
provided when a length modifier is given. 
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ICode 


Type of Constant 


|C 


v Ti&L iSC v^ i 


|x 


Hexadecimal 


|B 


Binary 


|F 


Fixed-point 


|H 


Fixed-point 


|E 


Floating-point 


|D 


Floating-point 


|L 


Floating-point 


|P 


Decimal 


|z 


Decimal 


|A 


Address 


l Y 


Address 


|S 


Address 


L . 


Address 


Figure 


8 . Type Codes for 



Machine Format 

8-bit code for each character 
4-bit code for each hexadecimal digit 
Binary format 

Signed, fixed-point binary format; normally a fullword 
Signed, fixed-point binary format; normally a half word 
Short floating-point format; normally a fullword 
Long floating-point format; normally a doubleword 
Extended floating-point format; normally two double words 
(DOS Assembler D 14K variant only) 
Packed decimal format 
Zoned decimal format 

Value of address; normally a fullword 
Value of address; normally a half word 
Base register and displacement value; a half word 
Space reserved for external symbol addresses; each address 
normally a fullword 



o 



Bit-Length Specification (F assembler 
only) ; The length of a constant, in bits, 
is specified by L.n, where n is specified 
as stated above and represents the number 
of bits in storage into which the constant 
is to be assembled. The value of n may 
exceed eight and is interpreted to mean an 
integral number of bytes plus so many bits. 
For example, L.20 is interpreted as a 
length of two bytes plus four bits. 



Assembly of the first or only constant 
with bit-length specification starts on a 
byte boundary. The constant is placed in 
the high- or low-order end of the field 
depending on the type of constant being 
specified. The constant is padded or 
truncated to fit the field. If the 
assembled length does not leave the 
location counter set at a byte boundary, 
and another bit length constant does not 
immediately follow in the same statement, 
the remainder of the last byte used is 
filled with zeros . This leaves the 
location counter set at the next byte 
boundary. Figure 9 shows a fixed- point 
constant with a specified bit-length of 13, 
as coded, and as it would appear in 
storage. Note that the constant has been 
padded on the left to bring it to its 
designated 13-bit length. 



As coded: 

r x ir 1 

| Name J Opera tion| Operand | 

,. + f { 

JBLCON JDC |FL.13 , 579 i j 

l i J. J 



In storage: 

byte byte byte 
■ padding! { 

| OOfrlOOlO 1000 1 1000 | 

579 fill 

Figure 9. Bit-Length Specification (Single 
Constant) 



The implied length of BLCON is two 
bytes. A reference to EICON would cause 
the entire two bytes to be referenced. 



When bit- length specification is used in 
association with multiple constants (see 
"Operand Subfield 4: Constant" following) , 
each succeeding constant in the list is 
assembled starting at the next available 
bit. Figure 10 illustrates this. 



As coded: 

r '~i t ' 1 

|Name |Operation| Operand | 

y 4 + 1 

JBLMCON |DC JFI. 10* 161, 21, 57' | 

I 1 I j 
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In storage: 



byte byte 



byte byte byte 

I I I I I 

| | padding | padding | 

I I I 1 I 

100101000 I 0100000 11 010100001 111001001 



161 



21 



57 



fill 



Figure 10. Bit-Length Specification 
(Multiple Constants) 



The symbol used as a name entry in a DC 
assembler instruction takes on the length 
attribute of the first constant in the 
list; therefore the implied length of 
BLMCON in Figure 10 is two bytes. 



If duplication is specified, filling 
occurs once at the end of the field 
occupied by the duplicated constant (s) . 



When bit-length specification is used in 
association with multiple operands, 
assembly of the constant (s) in each 
succeeding operand starts at the next 
available bit. Figure 11 illustrates this. 

As coded: 

r t i •■ 1 

J JOper-|Operand | 

| Name jationj j 

j. + f ., 

|BLMOCON|DC \FL.T9' ,CL. lO'AB'^L. 14 "C4« j 
l X J. J 



In storage: 

byte byte byte byte 

III! 
| padding | | padding | 



byte 
I 



1000100111 10000011110000001110001000, I 

' — ■ — " ■ ' ' ' ' J 

9 I A I C4 tfill 



A plus 
first two 
bits of B 



Figure 11. Bit-Length Specification 
(Multiple Operands) 



In Figure 11, three different types of 
constants have been specified, one to an 
operand. Note that the character constant 
'AB* which normally would occupy 16 bits is 
truncated on the right to fit the 10- bit 
field designated. Note that filling occurs 
only at the end of the field occupied by 
all the constants. 



SCALE MODIFIER : This modifier is written 
as Sn, where n is either a decimal value or 
an absolute expression enclosed by 
parentheses. Any symbol in the expression 
must be previously defined. The decimal 
value or the parenthesized expression may 
be preceded by a sign; if none is present, 
a plus sign is assumed. The maximum values 
for scale modifiers are summarized in 
Appendix F. 

A scale modifier may be used with 
fixed-point (F, H) and floating-point (E, 
D, and L) constants only. It is used to 
specify the amount of internal scaling that 
is desired, as follows. 

Scale Modifier for Fixed-Point Constants . 
The scale modifier specifies the power of 
two by which the constant must be 
multiplied after it has been converted to 
its binary representation. Just as 
multiplication of a decimal number by a 
power of 10 causes the decimal point to 
move, multiplication of a binary number by 
a power of two causes the binary point to 
move. This multiplication has the effect 
of moving the binary point away from its 
assumed position in the binary field; the 
assumed position being to the right of the 
rightmost position. 

Thus, the scale modifier indicates 
either of the following: (1) the number of 
binary positions to be occupied by the 
fractional portion of the binary number, or 
(2) the number of binary positions to be 
deleted from the integral portion of the 
binary number. A positive scale of x 
shifts the integral portion of the number x 
binary positions to the left, thereby 
reserving the rightmost x binary positions 
for the fractional portion. A negative 
scale shifts the integral portion of the 
number right, thereby deleting rightmost 
integral positions. If a scale modifier 
does not accompany a fixed-point constant 
containing a fractional part, the 
fractional part is lost . 

In all cases where positions are lost 
because of scaling (or the lack of 
scaling) , rounding occurs in the leftmost 
bit of the lost portion. The rounding is 
reflected in the rightmost position saved. 

Scale Modifier for Floating-Point 
Constants . Only a positive scale modifier 
may be used with a floating-point constant. 
It indicates the number of hexadecimal 
positions that the fraction is to be 
shifted to the right. Note that this shift 
amount is in terms of hexadecimal 
positions, each of which is four binary 
positions. (A positive scaling actually 
indicates that the point is to be moved to 
the left. However, a floating-point 
constant is always converted to a 



u 
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o 



fraction, which is hexadecimally normalized. 
The point is assumed to be at the left of 
the leftmost position in the field. Since 
the point cannot be moved left, the 
fraction is shifted right.) 

Thus, scaling that is specified for a 
floating-point constant provides an 
assembled fraction that is unnormalized, 
i.e., contains hexadecimal zeros in the 
leftmost positions of the fraction. When 
the fraction is shifted, the exponent is 
adjusted accordingly to retain the correct 
magnitude. When hexadecimal positions are 
lost, rounding occurs in the leftmost 
hexadecimal position of the lost portion. 
The rounding is reflected in the rightmost 
hexadecimal position saved. 

EXPONENT MODIFIER ; This modifier is 
written as En, where n is either a decimal 
self-defining term or an absolute 
expression enclosed by parentheses. Any 
symbols in the expression must be 
previously defined. The decimal value or 
the parenthesized expression may be 
preceded by a sign; if none is present, a 
plus sign is assumed. The maximum values 
for exponent modifiers are summarized in 
Appendix F. 

An exponent modifier may be used with 
fixed-point (F, H) and floating-point (E, 
D, and L) constants only. The modifier 
denotes the power of 10 by which the 
constant is to be multiplied before its 
conversion to the proper internal format. 

This modifier is not to be confused with 
the exponent of the constant itself, which 
is specified as part of the constant and is 
explained under "Operand Subfield 4: 
Constant." Both are denoted in the same 
fashion, as En. The exponent modifier 
affects each constant in the operand, 
whereas the exponent written as part of the 
constant only pertains to that constant. 
Thus, a constant may be specified with an 
exponent of +2, and an exponent modifier of 
♦5 may precede the constant. In effect, 
the constant has an exponent of +7. 

Note that there is a maximum value, both 
positive and negative, listed in Appendix F 
for exponents. This applies to the 
exponent modifier and to the sum of the 
exponent modifier and the exponent 
specified as part of the constant. 



Operand Subfield 4: Constant 



This subfield supplies the constant (or 
constants) described by the subfields that 
precede it. A data constant (all types 
except A, Y, S, and V) is enclosed by 



apostrophes. An address constant (types A, 
Y, S, and V) is enclosed by parentheses. 
To specify two or more constants in the 
subfield, the constants roust be separated 
by commas and the entire sequence of 
constants must be enclosed by the 
appropriate delimiters (i.e., apostrophes 
or parentheses) . Thus, the format for 
specifying the constant (s) is one of the 
following: 



r t 

| Single | Multiple 
j Constant j Constants 1 
h 



I 

| ' constant * | * constant , . . . , constant ' 
j (constant) J (constant, ... , constant) 

J. J. 



j 1 Not permitted for character, 

j hexadecimal, and binary constants. 

i 



All constant types except character (C) , 
hexadecimal (X) , binary (B) , packed decimal 
(P) , and zoned decimal (Z) , are aligned on 
the proper boundary, as shown in Appendix 
F, unless a length modifier is specified. 
In the presence of a length modifier, no 
boundary alignment is performed. If the 
operand specifies more than one constant, 
any necessary alignment applies to the 
first constant only. Thus, for an operand 
that provides five fullword constants, the 
first would be aligned on a fullword 
boundary, and the rest would automatically 
fall on fullword boundaries. 

The total storage requirement of the 
operand is the product of the length times 
the number of constants in the operand 
times the duplication factor (if present) 
plus any bytes skipped for boundary 
alignment. 

If an address constant contains a 
location counter reference, the location 
counter value that is used is the storage 
address of the first byte the constant will 
occupy. Thus, if several address constants 
in the same instruction refer to the 
location counter , the value of the 
location counter varies from constant to 
constant. Similarly, if a single constant 
is specified (and it is a location counter 
reference) with a duplication factor, the 
constant is duplicated with a varying 
location counter value. 

E and H constants are converted as if 
they were D and F, respectively, and then 
shortened. 

The subsequent text describes each of 
the constant types and provides examples. 
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Character Constant — C . Any of the valid 
256 punch combinations may be designated in 
a character constant. Only one character 
constant may be specified per operand. 

Special consideration must be given to 
representing apostrophes and ampersands as 
characters. Each apostrophe or ampersand 
desired as a character in the constant must 
be represented by a pair of apostrophes or 
ampersands. Only one apostrophe or 
ampersand appears in storage. 

The maximum length of a character 
constant is 256 bytes. No boundary 
alignment is performed. Each character is 
translated into one byte. Double 
apostrophes or double ampersands count as 
one character. If no length modifier is 
given, the size in bytes of the character 
constant is equal to the number of 
characters in the constant. If a length 
modifier is provided, the result varies as 
follows: 

1. If the number of characters in the 
constant exceeds the specified length, 
as many rightmost bytes as necessary 
are dropped. 

2. If the number of characters is less 
than the specified length; the excess 
rightmost bytes are filled with 
blanks. 

In the following example, the length 
attribute of FIELE is 12: 



r t t i 

| Name | Operation! Operand j 

(FIELD | DC | C 1 TOTAL IS 110* | 
L J. X J 

However, in this next example, the 
length attribute is 15, and three blanks 
appear in storage to the right of the zero: 



r ' t t i 

| Name | Operation j Operand | 

{FIELD |DC JCL15 'TOTAL IS 110' | 
i x x , J 

In the next example, the length 
attribute of FIELE is 12, although 13 
characters appear in the operand. The two 
ampersands count as only one byte. 

r t— t 1 

| Name | Operation | Operand | 

j. x x 4 

j FIELD j DC JC 1 TOTAL IS 6610' j 
i x x J 

Note that in the next example, a length 
of four has been specified, but there are 
five characters in the constant. 



r t t 1 

| Name | Operation | Operand j 

,. x x 4 

| FIELD j DC laCLa'ABCDE* j 

l x X , . j 



The generated constant would be: 

ABCDABCDABCD 

On the other hand, if the length had 
been specified as six instead of four, the 
generated constant would have been: 

ABCDE ABCDE AECDE 

Note that the same constant could be 
specified as a literal. 

r t t n 

| Name | Operation | Operand | 

| |MVC |AREA(12) ^CLa'ABCDE 1 | 

l X X J 



Hexadecimal Constant — X . A hexadecimal 
constant consists of one or more of the 
hexadecimal digits, which are 0-9 and A-F. 
Only one hexadecimal constant may be 
specified per operand. The maximum length 
of a hexadecimal constant is 256 bytes (512 
hexadecimal digits) . No word boundary 
alignment is performed. 

Constants that contain an even number of 
hexadecimal digits are translated as one 
byte per pair of digits. If an odd number 
of digits is specified, the leftmost byte 
has the leftmost four bits filled with a 
hexadecimal zero, while the rightmost four 
bits contain the odd (first) digit. 

If no length modifier is given, the 
implied length of the constant is half the 
number of hexadecimal digits in the 
constant (assuming that a hexadecimal zero 
is added to an odd number of digits) . If a 
length modifier is given, the constant is 
handled as follows: 

1. If the number of hexadecimal digit 
pairs exceeds the specified length, 
the necessary leftmost bits (and/or 
bytes) are dropped. 

2. If the number of hexadecimal digit 
pairs is less than the specified 
length, the necessary bits (and/or 
bytes) are added to the left and 
filled with hexadecimal zeros. 

An eight-digit hexadecimal constant 
provides a convenient way to set the bit 
pattern of a full binary word. The 
constant is the following example would set 
the first and third bytes of a word to 1 q s. 



u 
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%J 



r t T T 

I Name J Operation! Operand | 

j JD3 JOF I 

j TEST j DC JX^FFOOFFOO* j 

I X X J 



The DS instruction sets the location 
counter to a fullword boundary. 

The next example uses a hexadecimal 
constant as a literal and inserts 1s into 
bits 24 through 31 of register 5. 

r t ' t " 1 

| Name | Operation | Operand | 

j. + x 1 

| |IC JS^X'FF* INSERT CHAR. j 
I X X J 

In the following example , the digit A 
would be dropped, because five hexadecimal 
digits are specified for a length of two 
bytes : 

r t t 1 

| Name | Operation (Operand | 

|ALPHACON|DC |3XL2 , A6F4E I | 

i x x J 

The resulting constant would be 6F4E, 
which would occupy the specified two bytes. 
It would then be duplicated three times, as 
requested by the duplication factor. If it 
had merely been specified as X'AGFUE*, the 
resulting constant would have had a 
hexadecimal zero in the leftmost position: 

0A6FUE 



Binary Constant — B . A binary constant is 
written using 1*s and 0*s enclosed in 
apostrophes. Only one binary constant may 
be specified per operand. Duplication and 
length may be specified. The maximum 
length of a binary constant is 25 6 bytes. 

The implied length of a binary constant 
is the number of bytes occupied by the 
constant including any padding necessary. 
Padding or truncation takes place on the 
left. The padding bit used is a 0. 

The following example shows the coding 
used to designate a binary constant. BCON 
would have a length attribute of one. 

r t t i 

| Name | Operation | Operand | 

|BCON |DC IB 1 11011101' | 

JBTRUNC JDC |BL1» 10010001V | 

JBPAD |DC |BL1 a 101' I 

I x x j 



BTRUNC would assemble with the leftmost 
bit truncated, as follows: 

00100011 



BPAD would assemble with five zeros as 
padding, as follows: 

00000101 



Fixed-Point Constants — F and H . A 
fixed-point constant is written as a 
decimal number, which may be followed by a 
decimal exponent if desired. The number 
may be an integer, a fraction, or a mixed 
number (i.e., one with integral and 
fractional portions) . The format of the 
constant is as follows: 

1. The number is written as a signed or 
unsigned decimal value. The decimal 
point may be placed before, within, or 
after the number, or it may be 
omitted, in which case the number is 
assumed to be an integer. A positive 
sign is assumed if an unsigned number 
is specified. Unless a scale modifier 
accompanies a mixed number or 
fraction, the fractional portion is 
lost, as explained under "Subfield 3: 
Modifiers." 

2. The exponent is optional. If 
specified, it is written immediately 
after the number as En, where n is an 
optionally signed decimal value 
specifying the exponent of the factor 
10. The exponent may be in the range 
-85 to +75. If an unsigned exponent 
is specified, a plus sign is assumed. 
The exponent causes the value of the 
constant to be adjusted by the power 
of 10 that it specifies. The exponent 
may exceed the permissible range for 
exponents provided that the sum of the 
exponent and the exponent modifier do 
not exceed that range. 

The number is converted to a binary 
number. The binary number is then rounded 
and assembled into the proper field, 
according to the specified or implied 
length. If the value of the number exceeds 
the length specified or implied, the sign 
is lost, the necessary leftmost bits are 
truncated to the length of the field and 
the value is then assembled into the whole 
field. Any duplication factor that is 
present is applied after the constant is 
assembled. A negative number is carried in 
2's complement form. The resulting number 
will not differ from the exact value by 
more than one in the last place. 

An implied length of four bytes is 
assumed for a fullword (F) and two bytes 
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for a half word (H) , and the constant is 
aligned to the proper full word or half word 
boundary, if a length is not specified. 
However, any length up to and including 
eight bytes may be specified for either 
type of constant by a length modifier, in 
which case no boundary alignment occurs. 

Maximum and minimum values, exclusive of 
scaling, for fixed-point constants are: 



Lenqth 


Max 


Min 


8 


2 63 -1 


-2 63 


4 


2 3a -1 


-2 31 


2 


2 15_1 


_2* 5 


1 


2 7 -1 


-2 7 


.4 


2 3 -1 


-2 3 


.2 


2«-1 


-2" 


.1 





-1 



A field of three fullwords is generated 
from the statement shown below. The 
location attribute of CONWRD is the address 
of the leftmost byte of the first word, and 
the length attribute is four, the implied 
length for a fullword fixed- point constant. 
The expression CONWRE+4 could be used to 
address the second constant (second word) 
in the field. 

r t t 1 

| Name J Operation | Operand | 

j. x x .| 

j CONWRD JDC \ 3F» 658474* j 

1 j. x J 

The next statement causes the generation 
of a two-byte field containing a negative 
constant. Notice that scaling has been 
specified in order to reserve six bits for 
the fractional portion of the constant. 

r t t 1 

| Name | Operation | Operand { 

,. x x 1 

|HALFCON|DC |HS6 •-25.46' | 

i. X X J 

The next constant (3.50) is multiplied 
by 10 to the -2 before being converted to 
its binary format. The scale modifier 
reserves twelve bits for the fractional 
portion. 

r T T . ., 

| Name | Operation | Operand | 

,. x x -I 

JFULLCONjDC j HS 12' 3. 50E-2* | 

L X X J 

The same constant could be specified as 
a literal: 



r t t T 

| Name | Operation (Operand | 

| |AH |7,=HS12 , 3.50E-2» | 
L X X ; J 



The final example specifies three 
constants. Notice that the scale modifier 
requests four bits for the fractional 
portion of each constant. The four bits 
are provided whether or not the fraction 
exists. 

r t t 1 

| Name | Operation |0 perand | 

j. x x .| 

JTHREECONJDC |FS4» 1 0,25 .3 , 100* j 

L . X L J 

Floating-Point Constants — E f D f and L . A 
floating-point constant is written as a 
decimal number, which may be followed by a 
decimal exponent, if desired. The number 
may be an integer, a fraction, or a mixed 
number (i.e., one with integral and 
fractional portions) . The format of the 
constant is as follows: 

1 . The number is written as a signed or 
unsigned decimal value. The decimal 
point may be placed before, within, or 
after the number, or it may be 
omitted, in which case, the number is 
assumed to be an integer. A positive 
sign is assumed if an unsigned number 
is specified. 

2. The exponent is optional. If 
specified, it is written immediately 
after the number as En, where n is an 
optionally signed decimal value 
specifying the exponent of the factor 
10. The exponent may be in the range 
-85 to +78. The exponent may exceed 
the permissible range for exponents, 
provided that the sum of the exponent 
and the exponent modifier does not 
exceed that range. If an unsigned 
exponent is specified, a plus sign is 
assumed . 

Machine format for a floating-point 
number is in two parts: the portion 
containing the exponent, which is sometimes 
called the characteristic, followed by the 
portion containing the fraction, which is 
sometimes called the mantissa. Figure 12 
shows the external format of the three 
types of floating-point constants. 

As shown in the figure, the format of 
the type L constant is similar to that of 
two contiguous type E constants, except 
that it is assembled with the sign of the 
second double word equal to that of the 
first, and the characteristic of the second 
equal to that of the first minus 14, module 
128. The type L constant has been 
implemented to provide the programmer with 
extended precision floating-point 
constants. 

Since the machine format of a floating- 
point constant only consists of a fraction 



o 
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SHORT FLOATING POINT NUMBER (E) 

r T — — 1 1 

| ! 7 BIT I | 

| S | CHARAC- j | 

| | TERISTIC | | 

L X J J 

7 8 31 

LONG FLOATING POINT NUMBER (D) 

r t t 1 

| | 7 BIT | | 

j S j CHARAC- | 5 6 -BIT FRACTION j 

j I TERISTIC j j 

L X X J 

7 8 63 

EXTENDED FLOATING POINT NUMBER (L) 

r t 1 1 

| | 7 BIT | HIGH ORDER HALF OF | 

j S j CHARAC- j 112 BIT FRACTION j 

I j TERISTIC j j 

L X J J 

7 8 63 

r r 1 

j j LOW ORDER HALF OF j 

j | 112 BIT FRACTION j 

I X J 

7 8 63 

Figure 12. Floating-Point External Formats 



o 



%J 



and an exponent, the number specified as a 
floating-point constant must be converted 
to a fraction before it can be translated 
into the proper format. For example, the 
constant 27.35E2 represents the number 
27.35 times 10 to the 2nd. Represented as 
a fraction, it would be .2735 times 10 to 
the 4th, the exponent having been modified 
to reflect the shifting of the decimal 
point. The exponent may also be affected 
by the presence of an exponent modifier, as 
explained under "Operand Subfield 3: 
Modifiers. " 

The exponent is then translated into its 
binary equivalent, and the fraction is 
converted to a binary number. Scaling is 
performed if specified; if not, the 
fraction is normalized (leading hexadecimal 
zeros are removed) . Rounding of the 
fraction is then performed according to the 
specified or implied length, and the number 
is assembled into the proper field. Within 
the portion of the floating-point field 
allocated to the fraction, the hexadecimal 
point is assumed to be to the left of the 
leftmost hexadecimal digit, and the 
fraction occupies the leftmost portion of 
the field. Negative fractions are carried 
in true representation, not in the 2's 
complement form. The resulting number will 
not differ from the exact value by more 
than one in the last place. An implied 
length of four bytes is assumed for a short 



(E) constant and eight bytes for a long (D) 
constant. An implied length of 16 bytes is 
assumed for an extended (L) constant. The 
constant is aligned at the proper word (E) 
or double word (D and L) boundary if a 
length is not specified. However, any 
length up to and including eight bytes (E 
and D) or 16 bytes (L) can be specified by 
a length modifier. In this case, no 
boundary alignment occurs. 



Any of the following statements could be 
used to specify 46.415 as a positive, 
fullword, floating-point constant; the last 
is a machine instruction statement with a 
literal operand. Note that the last two 
constants contain an exponent modifier. 



r 






| Name 


(Operation | Operand 


I 


I- 


__X x 

|DC |E , 46.415 t 
|DC |E'46415E-3* 
|DC |E'+464.15E-1' 
|DC |E'+.46415E+2' 
|DC |EE2 f . 46415' 
|AE |6,=EE2'. 46415* 


1 






._ 1 



The following would each be generated as 
doubleword floating-point constants. 
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r t 1 1 

| Name | Operation J Operand | 

j. 4 4 ^ 

JFLOAT |DC |DE+4 , +46,-3.729,+473 f j 
l J. 4 J 



Decimal Constants — P and Z . A decimal 
constant is written as a signed or unsigned 
decimal value. If the sign is omitted, a 
plus sign is assumed. The decimal point 
may be written wherever desired or may be 
omitted. Scaling and exponent modifiers 
may not be specified for decimal constants. 
The maximum length of a decimal constant is 
16 bytes. No word boundary alignment is 
performed. 

The placement of a decimal point in the 
definition does not affect the assembly of 
the constant in any way, because, unlike 
fixed- point and floating-point constants, a 
decimal constant is not converted to its 
binary equivalent. The fact that a decimal 
constant is an integer, a fraction, or a 
mixed number is not pertinent to its 
generation. Furthermore, the decimal point 
is not assembled into the constant. The 
programmer may determine proper decimal 
point alignment either by defining his data 
so that the point is aligned or by 
selecting machine instructions that will 
operate on the data properly (i.e., shift 
it for purposes of alignment) . 

If zoned decimal format is specified 
(Z) , each decimal digit is translated into 
one byte. The translation is done 
according to the character set shown in 
Appendix A. The rightmost byte contains 
the sign as well as the rightmost digit. 
For packed decimal format (P) , each pair of 
decimal digits is translated into one byte., 
The rightmost digit and the sign are 
translated into the rightmost byte. The 
bit configuration for the digits is 
identical to the configurations for the 
hexadecimal digits 0-9 as shown in Section 
3 under "Hexadecimal Self -Defining Value." 
For both packed and zoned decimals, a plus 
sign is translated into the hexadecimal 
digit C, and a minus sign into the digit D. 

If an even number of packed decimal 
digits is specified, one digit will be left 
unpaired, because the rightmost digit is 
paired with the sign. Therefore, in the 
leftmost byte, the leftmost four bits will 
be set to zeros and the rightmost four bits 
will contain the odd (first) digit. 

If no length modifier is given, the 
implied length for either constant is the 
number of bytes the constant occupies 
(taking into account the format, sign, and 
possible addition of zero bits for packed 
decimals) . If a length modifier is given, 
the constant is handled as follows: 



1. If the constant requires fewer bytes 
than the length specifies, the 
necessary number of bytes is added to 
the left. For zoned decimal format, 
the decimal digit zero is placed in 
each added byte . For packed decimals , 
the bits of each added byte are set to 
zero. 

2. If the constant requires more bytes 
than the length specifies, the 
necessary number of leftmost digits or 
pairs of digits is dropped, depending 
on which format is specified. 

Examples of decimal constant definitions 
follow. 






r r t 

| Name J Operation | Operand 
j. 4 4 



DC 


|p*+i.25* 


DC 


iz^-sas' 


DC 


^■79.68' 


DC 


jpLs^g^s' 




._ _j._ 



The following statement specifies three 
packed decimal constants. The length 
modifier applies to each packed decimal 
constant. 

i r t 1 

| Name |Operation J Operand J 

j. 4 4 .j 

j DECIMALSI DC |PL8 • +25 .8 ,-3874 , + 2.3* j 
l J. L J 

The last example illustrates the use of 
a packed decimal literal. 

r t t ' 1 

J Name | Operation! Operand | 

j. 4 4 < 

j JUNPK |OUTAREA,=PL2 , *25 i | 

L -^^J^ 8. i 

ADDRESS CONSTANTS ; An address constant is 
a storage address that is translated into a 
constant. Address constants can be used 
for initializing base registers to 
facilitate the addressing of storage. 
Furthermore, they provide the means of 
communicating between control sections of a 
multisection program. However, storage 
addressing and control section 
communication are also dependent on the use 
of the USING assembler instruction and the 
loading of registers. Coding examples that 
illustrate these considerations are 
provided in Section 3 under "Programming 
with the Using Instruction." 

An address constant, unlike other types 
of constants, is enclosed in parentheses. 
If two or more address constants are 
specified in a statement, they are 
separated by commas, and the entire 
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sequence is enclosed by parentheses. There r r T t 

are four types of address constants: A, Y, | |Oper-| | 

S, and V. | Name j at ion j Operand j 

V 4 + 1 

|ACON|DC |A (108,LOP,END-STRT,*+4096) j 
Complex Relocatable Expressions . A complex j |LM | 4,7,=A (108,LOP,END-STRT,*+4096) j 

relocatable expression can only be used in ^ _i~- a. — — . — — — j 

an A-type or Y-type address constant. 

These expressions contain two or more 

u npaired relocatable terms and/or a Note ; When the location counter reference 

negative relocatable term in addition to occurs in a literal, as in the LM 

any absolute or paired relocatable terms instruction above, the value of the 

that may be present. In contrast to location counter is the address of the 

relocatable expressions, complex first byte of the instruction. 

relocatable expressions may represent 

negative values. A complex relocatable Y-type Address Constant . A Y-type address 

expression might consist of external constant has much in common with the A-type 

symbols (which cannot be paired) and constant. It, too, is specified as an 

designate an address in an independent absolute, relocatable, or complex 

assembly that is to be linked and loaded relocatable expression. The value of the 

with the assembly containing the address expression is also calculated to 32 bits as 

constant. explained in Section 2. However, the 

maximum value of the expression may be only 
2 i5 -1. The value is then truncated, if 
necessary, to the specified or implied 
length of the field and assembled into the 
rightmost bits of the field. The implied 
length of a Y-type constant is two bytes 
and alignment is to a halfword boundary 
unless a length is specified, in which case 
no alignment occurs. The maximum length of 
a Y-type address constant is two bytes. If 
length specification is used, a length of 
two bytes may be designated for a 
relocatable or complex expression and 1 or 
2 bytes (.1 (1 bit) to 2 bytes for DOS F) 
for an absolute expression. 



The value of the expression is 
determined when the referenced control 
sections are loaded. Complex relocatable 
expressions can be used to determine the 
distance between two control sections after 
they are loaded into main storage. 






A-Type Address Constant . This constant is 
specified as an absolute, relocatable, or 
complex relocatable expression. (Remember 
that an expression may be single term or 
multiterm.) The value of the expression is 
calculated to 32 bits as explained in 
Section 2, with one exception: the maximum 
value of the expression may be 2 3,, -1. The 
value is then truncated on the left, if 
necessary, to the specified or implied 
length of the field and assembled into the 
rightmost bits of the field. The implied 
length of an A-type constant is four bytes 
and alignment is to a full word boundary 
unless a length is specified, in which case 
no ^alignment will occur. The length that 
may be specified depends on the type of 
expression used for the constant; a length 
of 1-4 bytes (.1 (1 bit) to 4 bytes for DOS 
F) may be used for an absolute expressions, 
while a length of 3 or 4 bytes may be used 
for a relocatable or complex relocatable 
expression. 

In the following examples, the field 
generated from the statement named ACON 
contains four constants, each of which 
occupies four bytes. Note that there is a 
location counter reference in one. The 
value of the location counter will be the 
address of the first byte allocated to the 
fourth constant. The second statement 
shows the same set of constants specified 
as literals (i.e., address constant 
literals) . 



Caution : Specification of relocatable 
Y-type address constants should be avoided 
in programs destined to be executed on 
machines having more than 32,767 bytes of 
storage capacity. 

S-Type Address Constant . The S-type 
address constant is used to store an 
address in base displacement form. 

The constant may be specified in two 
ways: 

1 . As an absolute or relocatable 
expression, e.g., S (EETA) . 

2. As two absolute expressions, the first 
of which represents the displacement 
value and the second, the base 
register, e.g., S (400 (13)). 

The address value represented by the 
expression in (1) will be broken down by 
the assembler into the proper base register 
and displacement value. An S-type constant 
is assembled as a halfword and aligned on a 
halfword boundary. The leftmost four bits 
of the assembled constant represents the 
base register designation; the remaining 12 
bits, the displacement value. 
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If length specification is used, only 
two bytes may be specified. S-type address 
constants may not be specified as literals. 



V-Type Address Constant . This constant is 
used to reserve storage for the address of 
an external symbol that is used for 
effecting branches to other programs. To 
maintain compatibility with the OS 
assemblers, the constant should not be used 
for external data reference. The constant 
is specified as one relocatable symbol, 
which need not be identified by an EXTRN 
statement. Whatever symbol is used is 
assumed to be an external symbol by virtue 
of the fact that it is supplied in a V-type 
address constant. To suppress the AUTOLINK 
function of the linkage editor for a 
constant identified in a V-type address 
constant, the programmer can identify it in 
a WXTRN statement (DOS Assembler 11K D 
only) . 

Note that specifying a symbol as the 
operand of a V-type constant does not 
constitute a definition of the symbol for 
this assembly. The implied length of a 
V-type address constant is four bytes, and 
boundary alignment is to a fullword. A 
length modifier may be used to specify a 
length of either three or four bytes, in 
which case no such boundary alignment 
occurs. In the following example, 12 bytes 
will be reserved, because there are three 
symbols. The value of each assembled 
constant will be zero until the program is 
loaded. 
r T T ., 

| Name | Operation | Operand | 

j. + x i 

JVCONST JDC | V (SORT, MERGE, CALC) | 
l . X X J 

DS— DEFINE STORAGE 



The DS instruction is used to reserve areas 
of storage and to assign names to those 
areas. The use of this instruction is the 
preferred way of symbolically defining 
storage for work areas, input/output areas, 
etc. The typical form of the DS statement 
is: 

r t t 1 

| Name } Operation | Operand | 

|Any |DS |One operand (D assem- 
j symbol j jbler) or one or more 
| Or not | | operands (F assembler) 
| used j | in the format de- 

j scribed below, each 
| separated by a comma. 

L „. X X . 

The format of the DS operand is 
identical to that of the EC operand; 



exactly the same subfields are employed and 
are written in exactly the same sequence as 
they are in the DC operand. Although the 
formats are identical, there are two 
differences in the specification of 
subfields. They are: 

1 . The specification of data (subf ield 4) 
is optional in a DS operand, but it is 
mandatory in a DC operand. If a 
constant is specified, it must be 
valid. 

2. The maximum length that may be 
specified for character (C) and 
hexadecimal (X) field types is 65,535 
bytes rather than 256 bytes. 

If a DS operand specifies a constant in 
subf ield 4, and no length is specified in 
subf ield 3, the assembler determines the 
length of the data and reserves the 
appropriate amount of storage. It does not 
assemble the constant . The ability to 
specify data and have the assembler 
calculate the storage area that would be 
required for such data is a convenience to 
the programmer. If he knows the general 
format of the data that will be placed in 
the storage area during program execution, 
all he needs to do is show it as the fourth 
subf ield in a DS operand. The assembler 
then determines the correct amount of 
storage to be reserved, thus relieving the 
programmer of length considerations. 

If the DS instruction is named by a 
symbol, its value attribute is the location 
of the leftmost byte of the reserved area. 
The length attribute of the symbol is 
determined in the same manner as for a EC. 
Any positioning required for aligning the 
storage area to the proper type of boundary 
is done before the address value is 
determined. Bytes skipped for alignment 
are not set to zero* 

Each field type (e.g., hexadecimal, 
character, floating-point) is associated 
with certain characteristics (these are 
summarized in Appendix F) . The associated 
characteristics will determine which 
field-type code the programmer selects for 
the DS operand and what other information 
he adds, notably a length specification or 
a duplication factor. For example, the E 
floating-point field and the F fixed-point 
field both have an implied length of four 
bytes. The leftmost byte is aligned to a 
fullword boundary. Thus, either code could 
be specified if it were desired to reserve 
four bytes of storage aligned to a fullword 
boundary. To obtain a length of eight 
bytes, one could specify either the E or F 
field type with a length modifier of eight. 
However, a duplication factor would have to 
be used to reserve a larger area, because 
the maximum length specification for either 



/T" 



w 
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type is eight bytes. Note also that 
specifying length would cancel any special 
boundary alignment. 

In contrast, packed and zoned decimal (P 
and Z) , character (C) , hexadecimal (X) , and 
binary (B) fields have an implied length of 
one byte. Any of these codes, if used, 
would have to be accompanied by a length 
modifier, unless just one byte is to be 
reserved. Although no alignment occurs, 
the use of C and X field types permits 
greater latitude in length specifications, 
the maximum for either type being 65,535 
bytes. (Note that this differs from the 
maximum for these types in a DC 
instruction.) Unless a field of one byte 
is desired, either the length must be 
specified for the C, X, P, Z, or B field 
types, or else the data must be specified 
(as the fourth subf ield) , so that the 
assembler can calculate the length. 

To define four 10-byte fields and one 
100- byte field, the respective DS 
statements might be as follows: 

r r — 1 1 

| Name | Operation | Operand | 

,. + f .j 

JFIELD |DS J4CL10 j 

JAREA |DS JCL100 j 

l i. J. J 

Although FIELD might have been specified 
as one 40- byte field, the preceding 
definition has the advantage of providing 
FIELD with a length attribute of 10. This 
would be pertinent when using FIELD as a SS 
machine instruction operand. 

Additional examples of DS statements are 
shown below: 



Special Uses of the Duplication Factor 



FORCING ALIGNMENT : The location counter 
can be forced to a doubleword, fullword, or 
halfword boundary by using the appropriate 
field type (e.g., D, F, or H) with a 
duplication factor of zero. This method 
may be used to obtain boundary alignment 
that otherwise would not be provided. For 
example, the following statements would set 
the location counter to the next doubleword 
boundary and then reserve storage space for 
a 128 -byte field (whose leftmost byte would 
be on a doubleword boundary) . 



r t t 1 

| Name |Operation| Operand | 

j. + + , 

I IDS |0D | 

JAREA |DS JCL128 j 

I L J. J 



DEFINING FIELDS OF AN AREA : A DS 
instruction with a duplication factor of 
zero can be used to assign a name, to an 
area of storage without actually reserving 
the area. Additional DS and/or CC 
instructions may then be used to reserve 
the area and assign names to fields within 
the area (and generate constants if DC is 
used) . 



For example, assume that 80- character 
records are to be read into an area for 
processing and that each record has the 
following format: 



o 



JName j Operation! Operand 

j. + . f 

CL80 (one 80 -byte 

field, length 

attribute of 80) 

80C (80 one -byte 

fields, length 

attribute of one) 

6F (six f ullwords, 

length attribute of 

four) 

D (one doubleword, 

length attribute of 

eight) 

4H (four half words, 

length attribute of 

two) 



Note : A DS statement causes the storage 
area to be reserved but not set to zeros. 
No assumption should be made as to the 
contents of the reserved area. 




Positions 5-10 
Positions 11-30 
Positions 31-36 
Positions 47-54 
Positions 55-62 



Payroll Number 

Employee Name 

Date 

Gross Wages 

Withholding Tax 



The following example illustrates how ES 
instructions might be used to assign a name 
to the record area, then define the fields 
of the area and allocate the storage for 
them. Note that the first statement names 
the entire area by defining the symbol 
RDAREA; the statement gives REAREA a length 
attribute of 80 bytes, but does not reserve 
any storage. Similarly, the fifth 
statement names a 6 -byte area by defining 
the symbol DATE; the three subsequent 
statements actually define the fields of 
DATE and allocate storage for them. The 
second, ninth, and last statements are used 
for spacing purposes and, therefore, are 
not named. 
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Name 


"t - ~r 

(Operation Operand 
_j_ j- 


RDAREA 


r — r 
|DS 


0CL80 




|DS 


CL4 


PAYNO 


|DS 


CL6 


NAME 


|DS 


CL20 


DATE 


|DS 


0CL6 


DAY 


|DS 


CL2 


MONTH 


|DS 


CL2 


YEAR 


JDS 


CL2 




|DS 


CL10 


GROSS 


|DS 


CL8 


FEDTAX 


|DS 


CL8 


DS 




CL18 



L 



-X 



.0. J 



CCW — DEFINE CHANNEL COMMAND WORD 



The CCW instruction provides a convenient 
way to define and generate an eight- byte 
channel command word aligned at a 
doubleword boundary. The internal machine 
format of a channel command word is shown 
in Figure 12. CCW will cause any bytes 
skipped to be zeroed. The typical form of 
the CCW instruction statement is: 



I Name 



h 



- T ,, 

|Operation| Operand 



| Any | CCW j Four operands, 
symbol orj j separated by commas, 
not used j | specifying the 

contents of the 
channel command word 
in the format 
described in the 
following text. 



•i 



r t t 1 

| Name | Operation | Operand | 

j. + + , 

| | CCW ^rREADAREAfX'aS* ,80 | 

l J L _ I 



Note that the form of the third operand 
sets bits 37-39 to zero, as required. The 
bit pattern of this operand is as follows: 



32-35 
0100 



36-39 
1000 



If there is a symbol in the name entry 
of the CCW instruction, it is assigned the 
address value of the leftmost byte of the 
channel command word. The length attribute 
of the symbol is eight. 



j Byte j Bits 



Usage 



+ + ( 



1 

2-4 
5 



7-8 

L 



0-7 (Command code 
| 8-31 | Data address 
1 32-36 JFlags 
1 37-39 JMust be zero 
j 40-47 j Set to zero 
| 48-63 | Count 
.j. x 



Figure 13. Channel Command Word 






Listing Control Instructions 



All four operands must appear. They are 
written, from left to right, as follows: 

1 . An absolute expression that specifies 
the command code. This expression's 
value is right- justified in byte 1 . 

2. An expression specifying the data 
address. The value of this expression 
is in bytes 2-4. 

3 . An absolute expression that specifies 
the flags for bits 32-36 and zeros for 
bits 37-39. The value of this 
expression is right- justified in byte 
5. (Byte 6 is set to zero.) 

4. An absolute expression that specifies 
the count. The value of this 
expression is right- justified in bytes 
7-8. 

The following is an example of a CCW 
statement: 



The listing control instructions are used 
to identify an assembly listing and 
assembly output cards, to provide blank 
lines in an assembly listing, and to 
designate how much detail is to be included 
in an assembly listing. In no case are 
instructions or constants generated in the 
object program. Listing control statements 
except PRINT are not printed, unless the 
statement is continued. Then the first 
card of the statement will be printed. 



TITLE— IDENTIFY ASSEMBLY OUTPUT 



The TITLE instruction enables the 
programmer to identify the assembly listing 
and assembly output cards. The typical 
form of the TITLE instruction statement is 
as follows: 
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r 

I Name 

^ 

|A special 
j symbol, a 
J sequence 
| symbol, a 
| variable 
| symbol , or 
| not used 
i 



-r t 

| Operation | Operand 
.4 4 _ 

I TITLE J One to 100 

j (characters, 

j j enclosed in 

| j single 

j (apostrophes 






The name entry may contain a special 
symbol which is one to four alphabetic or 
numeric characters in any combination. The 
contents of the name entry are then punched 
into columns 73-76 of all the output cards 
for the program except those produced by 
the PUNCH and REPRO assembler instructions. 
Only the first TITLE statement in a program 
may have a special symbol or variable 
symbol in the name entry. The name field 
of all subsequent TITLE statements must be 
blank or contain a sequence symbol. 



The operand field may contain up to 100 
characters enclosed in apostrophes. Any 
ampersands or apostrophes enclosed within 
the surrounding apostrophes must be 
represented by two ampersands or 
apostrophes. 



The double ampersands and apostrophes 
punched into a TITLE card appear as single 
ampersands and apostrophes in a TITLE 
statement of an assembler listing. A 
single apostrophe between the enclosing 
apostrophes simply terminates the operand 
field. A single ampersand initiates an 
attempt to identify a variable symbol. If 
the variable symbol is not identifiable the 
statement is flagged as an error. 



However, it is the number of printed 
characters that are counted in the total 
number of operand characters. The contents 
of the name and operand field are printed 
at the top of each page of the assembly 
listing. 



A program may contain more than one 
TITLE statement. Each TITLE statement 
provides the heading for pages in the 
assembly listing that follow it, until 
another TITLE statement is encountered. 
Each TITLE statement encountered after the 
first one causes the listing to be advanced 
to a new page (before the heading is 
printed) . 

For example, if the following statement 
is the first TITLE statement to appear in a 
program: 



r 1 T ., 

| Name | Operation) Operand | 

j. 4 4 1 

JPGM1 JTITLE (•FIRST HEADING 1 J 

L— ——J.- J. j 

then, PGM1 is punched into all the output 
cards (columns 73-76) and this heading 
appears at the top of each cage: FIRST 
HEADING. 

If the following statement occurs later 
in the same program: 

r r ,-. 7 w , 

|Name (Operation | Operand | 

j. 4 4 4 

| (TITLE | "A NEW HEADING* j 
I J. JL J 

then, PGM1 is still punched into the output 
cards, but each following page begins with 
the heading: A NEW HEADING. 

Note : Ihe sequence number of the cards in 
the output deck is contained in columns 
77-80, except those produced by the PUNCH 
and REPRO assembler instructions. 



EJECI-- START NEW PAGE 



The EJECT instruction causes the next line 
of the listing to appear at the top of a 
new page. This instruction provides a 
convenient way to separate routines in the 
program listing. The typical form of the 
EJECI instruction statement is as follows: 

r *-t t- 1 

|Name (Operation (Operand ( 

j. 4 4 1 

| Sequence (EJECT |Not used; should | 
| symbol or J jbe blank j 

(not used | | j 

i i i j 

If the next line of the listing would 
appear at the top of a new page without the 
EJECI instruction, the EJECT instruction 
has no immediate effect. If one or more 
EJECT statements appear after the first 
EJECT, one or more pages are skipped. A 
TITLE instruction followed immediately by 
an EJECI instruction will result in a page 
with a title line and a statement heading 
line. Text following the EJECT instruction 
will begin at the top of the next page. 



SPACE— SPACE LISTING 



The SPACE instruction is used to insert one 
or more blank lines in the listing. The 
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typical form of the SPACE instruction 
statement is as follows : 



r r 1 1 

J Name | Ope ra ti on | Operand j 

h f f i 

(Sequence | SPACE |A decimal value | 
| symbol or| jor not used | 
| not used j j | 

i x j. j 

A decimal value is used to specify the 
number of blank lines to be inserted in the 
assembly listing. A blank operand causes 
one blank line to be inserted. If this 
value exceeds the number of lines remaining 
on the listing page, the statement will 
have the same effect as an EJECT statement. 



PRINT — PRINT OPTIONAL DATA 



The PRINT instruction controls the content 
of the assembly listing. The typical form 
of the PRINT instruction is: 

r 1 1 1 

| Name | Operation! Operand | 

,. f __j. 4 

{Sequence | PRINT I One to three | 
j symbol orj | operands J 

| not used j j J 

L X L .«._._.. J 

One to three of the following operands 
are used: 

ON A listing is printed. 

or 
OFF No listing is printed. 



GEN 



NOGEN 



or 



DATA 



or 



NODATA 



All statements generated by macro 
instructions are printed. 

Statements generated by macro 
instructions are not printed, 
except MNOTE messages which print 
regardless of NOGEN. However, 
the outer macro instruction 
itself will appear in the 
listing. 

Constants are printed out in full 
in the listing. 

Only the leftmost eight bytes (16 
hexadecimal digits) are printed. 



A program may contain any number of 
PRINT statements. The conditions set by a 
PRINT statement are in effect until another 
PRINT statement is encountered. 

If an operand is omitted, it is assumed 
to be unchanged and continues according to 
its last specification. 



When OFF is specified, GEN and DATA have 
no effect. When NOGEN is specified, DATA 
has no effect for generated constants. 



If no PRINT statement is encountered, 
the following default option is assumed: 



I T T 1 

| Name j Operation J Operand | 

j + 4 i 

j JPRINT j ON, NODATA, GEN j 

l„ JL Jl 1 

For example, if the statement: 

r t — ■ t • 1 

(Name |Operation J Operand | 

j. + + , 

j (DC |XL256 , 00* j 

appears in a program, 256 bytes of zeros 
are assembled. If the statement: 

, T — T 1 

| Name (Operation (Operand j 

j x x 1 

j (PRINT (DATA j 

I 1 X 1 J 

is the last PRINT statement to appear 
before the DC statement, all 256 bytes of 
zeros are printed in the assembly listing. 
However, if there are no previous PRINT 
st at ement s , or : 

I T T 1 

| Name (Operation (Operand | 

j. s x 1 

j j PRINT (NODATA j 

1 J. X 1 

is the last PRINT statement to appear 
before the DC statement, only eight bytes 
of zeros are printed in the assembly 
listing. 



Program Control Instructions 



The program control instructions are used 
to specify the end of an assembly, to set 
the location counter to a value or ha If word 
boundary, to insert previously written 
coding in the program, to specify the 
placement of literals in storage, to check 
the sequence of input cards, to indicate 
statement format, and to punch a card. 
Except for the CNOP and COPY instructions , 
none of these assembler instructions 
generate instructions or constants in the 
object program. 



jf 1 



(1 J 
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ICTL— INPUT FORMAT CONTROL 



The ICTL instruction allows the programmer 
to alter the format of the statements in 
his source module. It can only be used to 
control statements that are read from the 
system input file (SYSIPT) . It cannot be 
used to control the format of the input 
from the source statement library. 
Statements that are brought in from that 
library (through macro instructions or COPY 
instructions) are always assumed to be in 
the standard format. 



The ICTL statement must precede all 
other statements , and may only be used 
once. Its format is: 



r t t 1 

| Name | Operation] Operand | 

H f f \ 

JNot used, | ICTL | 1-3 decimal | 
| must not j lvalues of the | 
| be present | jform b,e,c j 
t i. j j 



Operand b specifies the begin column of 
the source statement. It must always be 
specified, and must be from 1-40, 
inclusive. Operand e specifies the end 
column of the source statement. The end 
column, when specified, must be from 41-80, 
inclusive; when not specified, it is 
assumed to be 71. The column after the end 
column is used to indicate whether the next 
card is a continuation card. Operand c 
specifies the continue column of the source 
statement. The continue column, when 
specified, must be from 2-40 and must be 
greater than b. If the continue column is 
not specified, or if column 80 is specified 
as the end column, the assembler assumes 
that there are no continuation cards, and 
all statements must be contained on a 
single card. The operand forms b,,c and b, 
are invalid. 

If no ICTL statement is used in the 
source program, the assembler assumes that 
1, 71, and 16 are the begin, end, and 
continue columns, respectively. 

The next example designates the begin 
column as column 25. Since the end column 
is not specified, it is assumed to be 
column 71. No continuation cards are 
recognized because the continue column is 
not specified. 

r t 1 i 

| Name | Operation) Operand j 

j. + f i 

| | ICTL | 25 j 

L X J. J 



ISEQ — INPUT SEQUENCE CHECKING 



The ISEQ instruction is used to check the 
sequence of input cards. The typical form 
of the ISEQ instruction statement is as 
follows: 

r T T _,. ., 

| Name | Operat ion | Operand | 

,. 4 + 1 

| Not used, | ISEQ | Two decimal | 
| must not j lvalues of the j 
| be present j jform 1, r, or j 
j j | not used j 
i u. j. , J 

The operands 1 and r, respectively, 
specify the leftmost and rightmost columns 
of the field in the input cards to be 
checked. Operand r must be equal. to or 
greater than operand 1. Columns to be 
checked must not be between the "begin" and 
"end" columns. 

Sequence checking begins with the first 
card following the ISEQ statement. 
Comparison of adjacent cards makes use of 
the eight-bit internal collating sequence. 
Each card checked must be higher than the 
preceding one. 

An ISEQ statement with a blank operand 
terminates the operation. Checking may be 
resumed with another ISEQ statement. 

Sequence checking is only performed on 
statements contained in the source program. 
Statements inserted by the COPY assembler 
instruction or generated by a macro 
instruction are not checked for sequence. 



PUNCH—PUNCH A CARD 



The PUNCH assembler instruction causes the 
data in the operand to be punched intc a 
card. One PUNCH statement produces one 
punched card. As many PUNCH statements may 
be used as are necessary. The typical form 
is: 



r t t i 

JName |Operation| Operand | 

,. 4 x 1 

| Sequence JPUNCH |1 to 80 characters | 
j symbol or j j enclosed in j 

jnot used j j j apostrophes j 
i j . 1 j 

Using character representation, the 
operand is written as a string of up to 80 
characters enclosed in apostrophes. All 
characters, including blank, are valid. 
The position immediately to the right of 
the left apostrophe is regarded as column 
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one of the card to fce punched. The 
assembly program does not process the data 
in the operand of a PUNCH statement other 
than causing it to be punched in a card. 
For each apostrophe or ampersand desired in 
the operand, two apostrophes or ampersands 
must be written. The two apostrophes or 
ampersands are reduced to a single 
apostrophe or ampersand. However, they 
count as only one character in the operand. 

PUNCH statements may occur anywhere 
within a program, except before macro 
definitions. They may occur within a macro 
definition but not between a MEND statement 
and the beginning of the next macro. If a 
PUNCH statement occurs before the first 
control section, the resultant card will 
precede all other cards in the object 
program card deck; otherwise the card will 
be punched in place. No sequence number or 
identification is punched in the card. 



REPRO- -REPRODUCE FOLLOWING CARD 



The REPRO assembler instruction causes data 
on the following statement line to be 
punched intc a card. The data is not 
processed; it is punched in a card and no 
substitution is performed for variable 
symbols. No sequence number or 
identification is punched in the card. One 
REPRO instruction produces one punched 
card. The REPRO instruction may not appear 
before a macro definition. 



r t t 1 

| Name |Operation J Operand | 

j. + s .( 

| Sequence JORG |A relocatable ex- | 
jsymbol or j Jpression or not used j 
j not used j j j 

i x j J 

Any symbols in the expression must have 
been previously defined. The unpaired 
relocatable symbol must be defined in the 
same control section in which the ORG 
statement appears. 

The location counter is set to the value 
of the expression in the operand. If the 
operand is omitted, the location counter is 
set to a location that is one byte higher 
than the maximum location assigned for the 
control section up to this point. 

An ORG statement must not be used to 
specify a location below the beginning of 
the control section in which it appears. 
The effect would be to give the location 
counter a large value. For example, the 
statement: 

r t t 1 

| Name |Operation| Operand J 

j. + 4 ^ 

| JORG j*-500 | 

t JL 1 J 

is invalid if it appears less than 500 
bytes from the beginning of, the current 
control section. 



o 






REPRO statements that occur before all 
statements composing the first or only 
control section will punch cards which 
precede all cards of the object deck. The 
form is: 

r t t 1 

JName | Opera tion| Operand j 

j. f f 4 

| Sequence | REPRO | Not used, should | 
jsymbol orj J not be present j 
J not used | | j 

i s. j. j 

The line to be reproduced may contain 
any combination of up to 80 characters. 
Characters may be entered starting in 
column 1 and continue through column 80 of 
the line. Column 1 of the line corresponds 
to column 1 of the card to be punched. 



If it is desired to reset the location 
counter to the next available location in 
the current control section, the following 
statement would be used: 

r "j t 1 

JName |Operation| Operand | 

j. 4 s .j 

I IORG I I 

I L I ,— ^ J 

If previous CRG statements have reduced 
the location counter for the purpose of 
redefining a portion of the current control 
section, an ORG statement with an omitted 
operand can then be used to terminate the 
effects of such statements and restore the 
location counter to its highest setting. 



LTORG— BEGIN LITERAL FCCL 



ORG--SET LOCATION COUNTER 



The ORG instruction is used to alter the 
setting of the location counter for the 
current control section. The typical form 
of the ORG instruction statement is: 



The LTORG instruction causes all literals 
since the previous LTORG or beginning of 
the program to be assembled at appropriate 
boundaries starting at the first dcubleword 
boundary following the LTCRG statement. If 
no literals follow the LTORG statement. 



\_jr 
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alignment of the next instruction will 
occur. Bytes skipped are not zeroed. The 
typical form, of the LTORG instruction 



r t ' — — t 

I Name | Operation! Operand 



F 

JAny | LTORG 

j symbol j 

I or not j 

j used j 

l x 



JNot used, should 
j not be present 



The symbol represents the address of the 
first byte of the literal pool. It has a 
length attribute of one. 

The literal pool is organized into four 
segments within which the literals are 
stored in order of appearance, dependent on 
the divisibility properties of their object 
lengths (dup factor times total explicit or 
implied length) . The first segment 
contains all literals whose object length 
is a multiple of eight. Those remaining 
literals with lengths divisible by four are 
stored in the second segment. The third 
segment holds the remaining even length 
literals. Any literals left over have odd 
lengths and are stored in the fourth 
segment. 

Since each literal pool begins at a 
doubleword boundary, this guarantees that 
all segment one literals are doubleword, 
segment two fullword, and segment three 
half word aligned, with no space wasted 
except, possibly, at the pool origin. 

Literals from the following statement 
are in the pool, in the segments indicated 
by the circled numbers, 



IVC 


A (6) ^HM' 


AD 


2,=D , 1* 


LM 


3,5,=3F'V 


IC 


2,=XL1'1' 


AC 


2,=C , 2' 



® 



® 



in subsequent control sections. If the 
programmer does not wish to reserve a 
register for this purpose, he may place a 
LTORG statement at the end of each control 
section, thereby ensuring that all literals 
appearing in that section are addressable. 



CNOP-- CONDITIONAL NO OPERATION 



The CNOP instruction allows the programmer 
to align an instruction at a specific word 
boundary. If any bytes must be skipped in 
order to align the instruction properly, 
the assembler insures an unbroken 
instruction flow by generating no-operation 
instructions. This facility is useful in 
creating calling sequences consisting of a 
linkage to a subroutine followed by 
parameters such as channel command words 
(CCW) . 

The CNOP instruction insures the 
alignment of the location counter setting 
to a ha If word, word, or doubleword 
boundary. If the location counter is 
already properly aligned, the CNOP 
instruction has no effect. If the 
specified alignment requires the location 
counter to be incremented, one to three 
no-operation instructions are generated, 
each of which uses two bytes. 

The typical form of the CNOP instruction 
statement is as follows: 

r t t 1 

| Name lOperationj Operand J 

•j. -4 4 1 

| Sequence J CNOP |Two absolute | 
j symbol or j {expressions of j 
| not used j jthe form b,w j 
i j j j 

Any symbols used in the expressions in 
the operand field must have been previously 
defined. 



© 



S pecial Addressing Consideration 



Any literals used after the the last LTORG 
statement in a program are placed at the 
end of the first control section. If there 
are no LTORG statements in a program, all 
literals used in the program are placed at 
the end of the first control section. In 
these circumstances the programmer must 
ensure that the first control section is 
always addressable. This means that the 
base address register for the first control 
section should not be changed through usage 



Operand b specifies at which byte in a 
word or doubleword the location counter is 
to be set; b can be 0, 2, 4, or 6. Operand 
w specifies whether byte b is in a word 
(w=4) or doubleword (w=8) . The following 
pairs of b and w are valid: 

b f w Specifies 

0,4 Beginning of a word 

2,4 Middle of a word 

0, 8 Beginning of a doubleword 

2,8 Second half word of a doubleword 

4,8 Middle (third half word) of a 

doubleword 

6,8 Fourth halfword of a doubleword 
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r 1 

| Double word | 

j. _ T ^ 

| Word | Word j 

f t f t- ^ 

| Halfword j Halfword j Halfword | Halfword j 

I I I I I I I I I 
| Byte | Byte | Byte |Byte j Byte | Byte | Byte |Byte | 

j. X 4. X X X X X \ 

I I 

|0,4 2,4 0,4 2,4 | 

|0,8 2,8 4,8 6,8 | 

L *.+ J 



C^ 



Figure 14. CNOP Alignment 



Figure 14 shows the position in a double 
word that each of these pairs specifies. 
Note that both 0,4 and 2,4 specify two 
locations in a doubleword. 

Assume that the location counter is 
currently aligned at a doubleword boundary. 
Then the CNOP instruction in this sequence: 

r t - t 1 

|Name | Opera tion| Operand | 

j. x x 1 

j JCNOP j 0,8 | 

| |BALR | 2, 14 | 

l X X J 

has no effect. However, this sequence: 

r t r 1 

| Name | Opera tion| Operand j 

,. x x < 

| |CNOP |6,8 | 

| |BALR | 2, 14 | 

t x x j 

causes three branch-on-conditions 
(no- ope rations) to be generated, thus 
aligning the BALR instruction at the last 
halfword in a doubleword as follows: 

r t t 1 

| Name | Operation | Operand J 

j. x x 1 

j JBCR j 0,0 j 

j JBCR | 0,0 | 

| JBCR | 0,0 | 

| JBALR |2,14 | 

I x X . J 

After the BALR instruction is generated, 
the location counter is at a doubleword 
boundary, thereby insuring an unbroken 
instruction flow. 



N ote : If the location counter is on an 
odd-numbered byte-boundary when a CNOP 
instruction is encountered, normal 
alignment occurs before the CNOP is 
processed . 



COPY— COPY PREDEFINED SOURCE CODING 



The COPY instruction obtains source 
language coding from a system library and 
includes it in the program currently being 
assembled. Under the DCS D Assembler, 10K 
Variant, the coding to be included is 
obtained from the system source statement 
library. Under the DOS D Assembler, 14K 
Variant, and the DCS F Assembler, the 
coding to be included is obtained from the 
private source statement library, if one is 
assigned, or from the system source 
library, in that order of precedence. 
Under the TOS D Assembler, 10K and 14K 
Variants, the coding to be included is 
obtained from the standard private library. 
The form of the COPY instruction statement 
is as follows : 

r t t 1 

| Name | Operat ion | Operand | 

j. x x ) 

|Not used, | COPY | One symbol | 
j must not J j J 

j be present J j | 

i l x J 

The operand is a symbol that identifies 
the section of coding to be copied. The 
symbol must not be the same as the mnemonic 
operation code of a macro definition in the 
source statement library. 

The assembler inserts the requested 
coding immediately after the COPY statement 
is encountered. The requested coding may 
not contain another CCPY statement. 

If identical COFY statements are 
encountered, the coding they request is 
brought into the program each time. 

Copied text is always in the normal 
format and is not governed by ICIL usage. 
See "Copy Statements" in Section 7 for 
further information. The procedure for 
placing source language coding in the 
system library is described in the System 
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Control and System Service Programs 
publication listed in the "Preface." 



The operand specifies the point to which 
control may be transferred when loading is 
complete. For example: 



END — END ASSEMBLY 



The END instruction terminates the assembly 
of a program. It may also designate a 
point in the program or in a separately 
assembled program to which control may be 
transferred after the program is loaded. 
The END instruction must always be the last 
statement in the source program. 

The typical form of the END instruction 
statement is as follows: 

r r t 1 

J Name | Ope rati on | Ope rand | 

h f f 1 

|A sequence | END |A relocatable | 
I symbol or | j expression or j 
| not presentj jnot present j 
i j. i. j 



r r t 

I Name |Operation| Operand 



h 



NAME |CSECT 
AREA |DS 
BEGIN | EALR 
I USING 



END 



|50F 
|2,0 
I*, 2 



I BEGIN 



Note; 



If macro instructions from the 



Source Statement library are included in an 
assembly, errors detected during macro 
editing will be flagged after the END 
statement. The error messages do not 
follow the macro instructions, because the 
source statements are not available to the 
assembler during macro editing. Errors 
detected while editing Programmer Macros 
will be flagged inline. 



o 
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Part 3-Conditional Assembly and Macro Facilities in the 

Assembler Language 



Organization of this Part of the Publication 

Section 6 gives an introduction to the conditional assembly and macro 
facilities in the assembler language. 

Sections 7 and 8 describe the basic rules for preparing macro 
definitions and for writing macro instructions. 

Section 9 describes the rules for writing conditional assembly 
instructions. 

Section 10 describes additional features including rules for de- 
fining global SET symbols, preparing keyword and mixed-mode macro 
definitions, and writing keyword and mixed-mode macro Instructions. 

Appendix G contains a reference summary of the complete macro 
facilities. 

Examples of the use of the features of the language appear through- 
out the remainder of the publication. These examples illustrate the 
use of particular features. However, they are not meant to show the 
full versatility of these features. 
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Section 6. Introduction to the Conditional Assembly and 

Macro Facilities 
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The DOS/TOS conditional assembly and macro 
facilities are part of the DOS/TOS 
assembler language. 

Conditional assembly allows one to 
specify assembler language statements which 
may or may not be assembled, depending upon 
conditions evaluated at assembly time. 
Conditional assembly statements are used to 
define, set, change, and test values during 
the course of the assembly itself. 

The conditional assembly instructions 
may be used to vary the sequence of 
statements generated for each occurrence of 
a macro instruction. Conditional assembly 
instructions may also be used outside macro 
definitions, i.e. , among the assembler 
language statements in the program. 

The macro facilities provide the 
programmer with a convenient way of 
generating desired sequences of machine or 
certain assembler instructions many times 
in one or more programs. This is 
accomplished by writing a macro definition. 

This macro definition is written only 
once, and a single statement, a macro 
instruction statement, is written each time 
a programmer wants to generate the desired 
sequence of statements. 

The macro facilities simplify the coding 
of programs , reduce the chance of 
programming errors, and ensure that 
standard sequences of statements are used 
to accomplish desired functions. 



The Macro Instruction Statement 

A macro instruction statement (also called 
a macro instruction) is a source program 
statement used to provide information for 
generating machine and assembler 
instructions from a macro definition. The 
generated instructions are source 
statements which are then processed by the 
assembler program. 

Three types of macro instructions may be 
written. Each type has a different form of 
operand. They are: 

1. Positional (Sections 7 and 8) . 

2. Keyword (Section 10) . 



3. Mixed-mode (Section 10) . 

Positional macro instruction operands 
are written in a fixed order. 

Keyword macro instruction operands can 
be written in any order. 

Mixed-mode macro instruction operands 
are a combination of both positional and 
keyword operands. That is, certain operand 
entries (positional) must be written in a 
fixed order; other operand entries 
(keyword) can be specified in any order. 



The Macro Definition 



Before a macro instruction can be 
assembled, a macro definition must be 
available to the assembler. 

A macro definition is a set of 
statements that provide the assembler with: 

1. The name entry, mnemonic operation 
code, and the form of the macro 
instruction operand, and 

2. The sequence of statements the 
assembler uses when the macro 
instruction appears in the source 
program. 

Every macro definition consists of a 
macro definition header statement, a macro 
instruction prototype statement, a sequence 
of model statements, COPY statements, 
MEXIT, MNOTE, or conditional assembly 
instructions, and a macro definition 
trailer statement. 

The macro definition header and trailer 
statements denote the beginning and end, 
respectively, of a macro definition. 

The macro instruction prototype 
statement specifies the name entry, 
mnemonic operation code, and the type of 
the macro instruction operand. 

The model statements contained in a 
macro definition may be used by the 
assembler to generate machine instructions 
and certain assembler instructions that 
replace each occurrence of the macro 
instruction. 

The COPY statements may be used to copy 
model statements, MEXIT instructions, MNOTE 
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instructions, and conditional assembly 
instructions from a source statement 
library into a macro definition. 

The MEXIT instruction can be used to 
terminate processing of a macro definition. 

The MNOTE instruction can be used to 
generate a message. 

The conditional assembly instructions 
may be used to vary the sequence of 
statements generated for each occurrence of 
a macro instruction. Conditional assembly 
instructions may also be used outside macro 
definitions, i.e., among the assembler 
language statements in the program. 

If a macro definition is inline with an 
assembly, it is called a programmer macro. 



Source Statement Libraries 



Editing errors in user- supplied macro 
definitions are found at the time the macro 
is read from the source statement library, 
i.e., after the END card. To determine 
where these errors are, it is necessary to 
punch all such macros, including inner 
macros, and insert them then in the source 
program as programmer macros. To aid in 
debugging it is advisable to run all macros 
as programmer macros before incorporating 
them in a source statement library. 



Varying the Generated Statements 



Each time a macro instruction appears in 
the source program, it is replaced by the 
same sequence of assembler language 
statements. Conditional assembly 
instructions, however, may be used to vary 
the number and format of the generated 
statements. 






The same macro definition may be made 
available to more than one source program 
by placing the macro definition in the 
system source statement library. The macro 
definition then becomes a system macro. 
This system library is a collection of 
macro definitions that can be used by all 
the assembler language programs in an 
installation. Once a macro definition has 
been placed on the system souice statement 
library it may be used by writing a 
corresponding macro instruction in a source 
program. Macro definitions must be in the 
system source statement library under the 
same name as the prototype. The procedure 
for placing macro definitions in the system 
source statement library is described in 
the System Control and System Service 
Programs publication listed in the 
"Preface." 

System macro definitions provided by IBM 
are described in the Supervisor and 
Input/Output Macros publication, also 
listed in the "Preface." 



VARIABLE SYMBOLS 



A variable symbol is a type of symbol that 
is assigned various values by either the 
programmer or the assembler. Thus , 
variable symbols allow different values to 
be assigned to one symbol. When the 
assembler uses a macro definition to 
determine what statements are to replace a 
macro instruction, variable symbols in the 
model statements are replaced with the 
current values assigned to them. 

A variable symbol is written as an 
ampersand followed by from one to seven 
letters and/or digits, the first of which 
must be a letter. 



Types of Variable Symbols 






A macro definition may be made available 
to a specific assembly by placing the macro 
definition in a private source statement 
library. If the private source statement 
library is assigned at the time of 
assembly, the macro definitions in the 
private source statement library may be 
used by writing a corresponding macro 
instruction in a source program. The macro 
definitions in the private source statement 
library must be under the same name as the 
prototype. The procedure for placing macro 
definitions in the private source statement 
library is described in the System Control 
and System Service Programs publication 
listed in the "Preface." 



There are three types of variable symbols: 
symbolic parameters, system variable 
symbols, and SET symbols. The SET symbols 
are further broken down into SETA symbols, 
SETB symbols, and SETC symbols. The three 
types of variable symbols differ in how 
they are assigned values. 



Assigning Values to Variable Symbols 



Symbolic parameters are assigned values by 
the programmer each time he writes a macro 
instruction. 



■\^J 
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System variable symbols, except 
&SYSPARM. are assianed values by the 
assembler each time it processes a macro 
instruction. 

SET symbols are assigned values by the 
programmer by means of conditional assembly 
instructions . 



definitions. All SET symbols used for this 
purpose must be defined as global SET 
symbols. All other SET symbols must be 
defined by the programmer as local SET 
symbols. Local SET symbols and the other 
variable symbols (that is, symbolic 
parameters and system variable symbols) are 
local variable symbols. Global SET symbols 
are global variable symbols. 



Global SET Symbols 



The values assigned to SET symbols in one 
macro definition may be used in other macro 



o 



o 
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A macro definition consists of: 

1. A macro definition header statement. 

2. A macro instruction prototype 
statement. 

3. Zero or more model statements, COPY 
statements, MEXIT, MNOTE, or 
conditional assembly instructions. 

4. A macro definition trailer statement. 

Except for MEXIT, MNOTE, and conditional 
assembly instructions, this section of the 
publication describes the statements that 
may be used to prepare macro definitions. 
Conditional assembly instructions are 
described in Section 9. MEXIT and MNOTE 
instructions are described in Section 10. 



must be the last statement in every macro 
definition. The form of this statement is: 



r t t ■ 1 

| Name |Operation|Cperand | 

j. i ^ 1 

| Sequence |MEND |Not used, must | 
j symbol orj jnot be present | 
jnot used j j j 

I L JL J 

Ihis statement also tells the assembler 
to terminate processing of a macro 
definition. Processing can be terminated 
at some other point in a macro definition 
through the MEXIT instruction. 



Macro Instruction Prototype 



Macro definitions in a source program 
must appear before all PUNCH and REPRO 
statements which appear in the main 
program. Specifically, only the listing 
control instructions (EJECT, PRINT, SPACE, 
and TITLE) , ICTL and ISEQ instructions, and 
comments statements may occur before the 
macro definitions. All but the ICTL 
instruction may appear between macro 
definitions if there is more than one 
definition in the source program. 

Note : A macro definition cannot appear 
within a macro definition. 



MACRO-Macro Definition Header 



The macro definition header statement 
denotes the beginning of a macro 
definition. It must be the first statement 
in every macro definition. The form of 
this statement is: 

r i t 1 

| Name | Operation! Operand j 

j. 1 f 1 

| Not used, | MACRO jNot used, must | 
jmust not j | not be present | 
| be present j | j 

i i. i. j 



MEND-Macro Definition Trailer 



The macro instruction prototype statement 
(also called the prototype statement) 
specifies the name entry, mnemonic 
operation code, and the form of all macro 
instructions that refer to the macro 
definition. It must be the second 
statement of every macro definition. The 
typical form of this statement is: 

r t T 1 

| Name |Operation| Operand J 

j. + + .j 

| A symbolic |A symbol | Zero to 100 (200 J 

j parameter j jfor F assembler) j 

j or not j j symbolic parameters , j 

(used j j separated by commas J 

l -L -L J 

The symbolic parameters are used in the 
macro definition to represent the name 
entry and operands of the corresponding 
macro instruction. A description of 
symbolic parameters appears following 
"Model Statements." 

Ihe name entry of the prototype 
statement may be unused or it may contain a 
symbolic parameter. 

The symbol in the operation entry is the 
mnemonic operation code that must appear in 
all macro instructions that refer to this 
macro definition. The mnemonic operation 
code must not be the same as the mnemonic 
operation code of another macro definition 
in the source program or of a machine 
instruction or assembler instruction. 



The macro-definition trailer statement 
denotes the end of a macro definition. 



It 



The operand may contain zero to 100 
for F assembler) symbolic parameters 
separated by commas. 



(200 






4 V 
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The following is a prototype statement. 

r T T~ T 

|Name | Operation! operand } J- 

(. + + ^ 

J6NAME JMOVE j 6T0, 6FR0M j 

L X JL J 



Alternate Statement Form 



The prototype statement may be written in a 
form different from that used for machine 
or assembler instructions. The normal form 
is described in Part 1 of this publication. 
The alternate form described here allows 
the programmer to write an operand on each 
line, and allows the interspersing of 
operands and comments in the statement. 



In the alternate form, as in the normal 
form, the name and operation entries must 
appear on the first line of the statement, 
and at least one blank must follow the 
operation entry on that line. Both types 
of statement forms may be used in the same 
prototype statement. 



The rules for using the alternate 
statement form are: 

1. If an operand is followed by a comma 
and a blank, and the column after the 
end column contains a nonblank 
character, the operand entry may be 
continued on the next line starting in 
the continue column. More than one 
operand may appear on the same line. 

2. Comments may appear after the blank 
that indicated the end of an operand, 
up to and including the end column. 

3. If the next line starts after the 
continue column, the information 
entered on that line is considered to 
be comments, and the operand field is 
considered terminated. Any subsequent 
continuation lines are considered to 
contain only comments. 



Note ; A prototype statement may be written 
on as many continuation lines as is 
necessary to contain 100 (200 for F 
assembler) operands and associated 
comments . 

The following examples illustrate: (1) 
the normal statement form, (2) the 
alternate statement form, and (3) the 
combination of both statement forms. 



Name 
NAME1 



NAME2 



NAME3 



Oper- 
ation 



0P1 
0P2 



0P3 



Operand 



Comments 



OPERAND 1 , OPERAND2 , OPERAN j 
D3 THE NORMAL FORM | 



— I 
Xj 



OPERANDI, THIS IS THE ALJ 

OPERAND2,OPERAND3 TERNA j 

TE STATEMENT j 

FORM | 



-H 

X| 
X| 

x| 



OPERANDI, THIS IS A COMB) 
OPERAND2 , OPERAND3 , OPERAN | 
D4,OPERAND5 INATION OF | 
BOTH STATEMENT FORMATS I 



-i 
X| 
X| 
XI 



Model Statements 



Model statements are the macro definition 
statements from which the desired sequences 
of machine instructions and certain 
assembler instructions are generated. Zero 
or more model statements may follow the 
prototype statement. A model statement 
consists of one to four entries. They are, 
from left to right, the name, operation, 
operand, and comments entries. 

The name entry may be unused, or it may 
contain an ordinary symbol, a sequence 
symbol or a variable symbol, depending on 
the particular statement. (Neither * nor 
.* may be substituted in the begin column 
of a model statement.) 

The operation entry may contain any 
machine, assembler, or macro instruction 
code, except COPY, END, ICTL, ISEQ, and 
PRINT; or it may contain a variable symbol. 

Variable symbols may not be used to 
generate the following mnemonic operation 
codes: COPY, END, ICTL, CSECT, DSECT, 
PRINT, REPRO, START, MACRO, MEND, MEXIT, 

LCLA, LCLB, LCLC, GBLA, GBLB , GBLC , SETA, 
SETB, SETC, AIF, AIFB, AGO, AGOB , ANOP, 
ACTR, or macro instructions. 

Variable symbols may not be used in the 
name entry of the following instructions: 
ACTR, COPY, END, ICTL, or ISEQ. 

Variable symbols may not be used in the 
operand entry of the following 
instructions: COPY, ICTL, or ISEQ. 

Variable symbols may be used outside of 
macro definitions to generate mnemonic 
operation codes with the preceding 
restrictions . 

Although COPY statements may not be used 
as model statements, they may be part of a 
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macro definition. The use of COPY 
statements is described under "COPY 
Statements . " 

The operand entry may contain ordinary 
symbols or variable symbols. After 
substitution, the operand must not be 
greater than 127 (255 for F assembler) 
characters. Model statement fields must 
follow the rules for paired apostrophes, 
ampersands, and blanks, as macro 
instruction operands. (See "Macro 
Instruction Operands" in Section 8.) 
Sequence symbols must appear in the operand 
entry of AGO and AIF instructions. 

The comments entry may contain any 
combination of characters. Substitution by 
the use of variable symbols is not allowed. 

If a REPRO statement is used as a model 
statement, it must be explicitly written in 
the operation entry. It may not be 
generated as a result of replacing a 
variable symbol by its value. Also, the 
line following it may not contain variable 
symbols. Substituted statements may not 
have blanks in any fields except between 
paired apostrophes. They may not have 
leading blanks in the name or operand 
fields. 



Symbolic Parameters 



A symbolic parameter is a type of variable 
symbol consisting of an ampersand followed 
by one to seven letters and/or numbers, the 
first of which must be a letter. Symbolic 
parameters appear in prototype and model 
statements. They are assigned values by 
the programmer when he writes a macro 
instruction. The programmer may vary 
statements that are generated for each 
occurrence of a macro instruction by 
varying the values assigned to symbolic 
parameters. 

The programmer should not use SSYS as 
the first four characters of a symbolic 
parameter. 

The following are valid symbolic 
parameters : 

SREADER SL00P2 
SA23456 SN 
SX4F2 SS4 

The following are invalid symbolic 
parameters : 



6AREA2456 (more than seven characters 
after the ampersand) 

6BCD (34) (contains a special 

character other than initial 
ampersand) 

SIN AREA (contains a special 

character, i.e., blank, 
other than initial 
ampersand) 



The following is an example of a macro 
definition. Note that the symbolic 
parameters in the model statements appear 
in the prototype statement. 



r t t 

j Name | Operation | Operand 
j. x x 



Header 


I [MACRO 


1 




Prototype | SNAME | MOVE 


|STO,SFROM 




Model 


| SNAME | ST 


| 2 , SAVE 




Model 


I |L 


|2,6FROM 




Model 


I 1ST 


|2,ST0 




Model 


1 |L 


| 2, SAVE 




Trailer 


| | MEND 


I 













Symbolic parameters in model statements 
are replaced by the characters of the macro 
instruction operand that correspond to the 
symbolic parameters. 

In the following example the characters 
HERE, FIELDA, and FIELDB of the MOVE macro 
instruction correspond to the symbolic 
parameters SNAME, STQ, and SFROM, 
respectively, of the MOVE prototype 
statement . 

r t t 1 

| Name | Operation | Operand | 

j. x + .j 

j HERE JMOVE j FIELDA, FIELDB j 

L X . J. J 

Any occurrence of the symbolic 
parameters SNAME, STO, and SFROM in a model 
statement will be replaced by the 
characters HERE, FIELDA, and FIELDB, 
respectively. If the preceding macro 
instruction was used in a source program, 
the following assembler language statements 
would be generated: 



r t t 

| Name | Operation j Operand 



HERE 



|ST 

|L 
JST 

|L 
.X 



j 2, SAVE 
j 2, FIELDB 
J 2, FIELDA 
| 2, SAVE 

-X 






CARDAREA (first character is not an 

ampersand) 

6256B (first character after 

ampersand is not a letter) 



The following example illustrates 
another use of the MOVE macro instruction 
using operands different than those that 
appear in the preceding example. 
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c 



r t t 1 

(Name J Operation | Operand J 

Macro j LABEL J MOVE J IN, OUT J 

Generated | LABEL | ST | 2 , SAVE | 

Generated! |L J 2, OUT | 

Generated! |ST |2,IN j | 

Generated! JL | 2, SAVE | 

L X X J 

If a symbolic parameter appears in the 
comments field of a model statement, it is 
not replaced by the corresponding 
characters of the macro instruction. 



Concatenating Symbolic Parameters with 
Other Characters or Other Symbolic 
Parameters 



Concatenation is the process of linking or 
joining together in a sequence, with a 
specified order. To concatenate is to join 
together in a specified order. 

If a symbolic parameter in a model 
statement is immediately preceded or 
followed by other characters or another 
symbolic parameter, the characters that 
correspond to the symbolic parameter are 
combined, in the order given, in the 
generated statement, with the other 
characters or the characters that 
correspond to the other symbolic parameter. 
This process is called concatenation. 

The macro definition, macro instruction, 
and generated statements in the following 
example illustrate these rules. 



r t t 1 

(Name | Operation! Operand | 

| J MACRO | 

| STY, SP, STO, SFROM 

| 2, SAVE AREA 

J 2, SPSFROM 

|2,SP6TO 

J 2, SAVE AREA 



Header 

Prototype 

Model 

Model 

Model 

Model 

Trailer 

Macro 

Generated 
Generated 
Generated 
Generated 



JSNAMEJMOVE 
JSNAMEJSTSTY 
j JLSTY 
J j ST STY 
| JLSTY 
! I MEND 



\ + 

J HERE JMOVE 

\ + 

(HERE JSTD 

j JSTD 

I |LD 
L JU. 



JD, FIELD, A, I 
.X 

j 2, SAVE AREA 
J2,FIELDB 
|2,FIELDA 
J2,SAVEAREA 
-X 



The symbolic parameter STY is used in 
each of the four model statements to vary 
the mnemonic operation code of each of the 
generated statements. The character D in 
the macro instruction corresponds to 
symbolic parameter STY. Since STY is 



preceded by other characters (i.e., ST and 
L) in the model statements, the character 
that corresponds to STY (i.e., D) is 
concatenated with the other characters to 
form the operation fields of the generated 
statements . 

The symbolic parameters SP, STO, and 
SFROM are used in two of the model 
statements to vary part of the operand 
fields of the corresponding generated 
statements. The characters FIELD, A, and B 
correspond to the symbolic parameters SP, 
STO, and SFROM, respectively. Since SP is 
followed by SFROM in the second model 
statement, the characters that correspond 
to them (i.e., FIELD and B) are 
concatenated to form part of the operand 
field of the second generated statement. 
Similarly, FIELD and A are concatenated to 
form part of the operand field of the third 
generated statement. 

If the programmer wishes to concatenate 
a symbolic parameter with a letter, digit, 
left parenthesis, or period following the 
symbolic parameter he must immediately 
follow the symbolic parameter with a 
period. A period is optional if the 
symbolic parameter is to be concatenated 
with another symbolic parameter, or a 
special character other than a left 
parenthesis or another period that follows 
it. 

If a symbolic parameter is immediately 
followed by a period, then the symbolic 
parameter and the period are replaced by 
the characters that correspond to the 
symbolic parameter. A period that 
immediately follows a symbolic parameter 
does not appear in the generated statement. 

The following macro definition, macro 
instruction, and generated statements 
illustrate these rules. 



r t t 

| Name J Operation | Operand 
j. x x 

Header j j MACRO | 
Prototype J 6NAME j MOVE 



|SP,SS,SR1,SR2 
|SR1,6S. (6R2) 
J6R1,SP.B 
JSR1,6P.A 
JSR1,6S. (SR2) 



Model jSNAMEtST 
Model | |L 
Model J | ST 
Model J |L 

Trailer j JMEND J 

L X X 

Macro | HERE JMOVE | FIELD, SAVE, 2, 4 

Generated | HERE J ST ! 2 , SAVE (4) 

Generated) JL |2,FIELDB 

Generated j j ST J 2 , FIELDA 

Generated ! j L j 2 , SAVE (4) 



The symbolic parameter SP is used in the 
second and third model statements to vary 
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part of the operand field of each of the 
corresponding generated statements. The 
characters FIELD of the macro instruction 
correspond to SP. Since SP is to be 
concatenated with a letter (i.e., B and A) 
in each of the statements, a period 
immediately follows 6P in each of the model 
statements. The period does not appear in 
the generated statements. 

Similarly, symbolic parameter SS is used 
in the first and fourth model statements to 
vary the operand fields of the 
corresponding generated statements. SS is 
followed by a period in each of the model 
statements, because it is to be 
concatenated with a left parenthesis. The 
period does not appear in the generated 
statements. 



Comments Statements 



A model statement may be a comments 
statement. A comments statement consists 
of an asterisk in the begin column, 
followed by comments. The comments 
statement is used by the assembler to 
generate an assembler language comments 
statement, just as other model statements 
are used by the assembler to generate 
assembler language statements. 

The programmer may also write comments 
statements in a macro definition which are 
not to be generated. These statements must 
have a period in the begin column, 
immediately followed by an asterisk and the 
comments . 

Comments statements are the only model 
statements which may be interspersed with 
the definitions of local and global SET 
symbol s . 

The first statement in the following 
example will be used by the assembler to 
generate a comments statement; the second 
statement will not. 

r —t t — ■ T 

(Name J Operation | Operand | 

f x— x _ ^ 

j* THIS STATEMENT WILL BE GENERATED j 
| . * THIS ONE WILL NOT BE GENERATED | 

I - : J 



The use of variable symbols for 
substitution in comments statements is not 
allowed. The * or .* of a comment 
statement, therefore, cannot be created by 
substitution for a variable symbol. 



COPY Statements 



A COPY statement is not a model statement. 
COPY statements may be used to copy model 
statements and MEXIT, MNOTE, and 
conditional assembly instructions into a 
macro definition from a system library, 
just as they may be used outside macro 
definitions to copy source statements into 
an assembler language program. Under the 
DOS D Assembler, 10K Variant, the coding to 
be included is obtained from the system 
source statement library. Under the DOS D 
Assembler, 14K Variant, and the DOS F 
Assembler, the coding to be included is 
obtained from the private source statement 
library, if one is assigned, or from the 
system source library, in that order of 
precedence. Under the TOS D Assembler, 10K 
and 14K Variants, the coding to be included 
is obtained from the standard private 
library. 

The form of this statement is : 

r , T T ., 

(Name | Operat ion | Operand | 

|. x x .j 

(Not used, j COPY |A symbol | 

| must not | j j 

| be present j ■ j j 

L X X J 

The symbol in the operand entry 
identifies the section of coding to be 
copied. The symbol must not be the same as 
the operation mnemonic of a macro 
definition in a source statement library. 
Any statement that may be used in a macro 
definition may be part of the copied 
coding, except MACRO, MEND, COPY, and 
prototype statements. 

Statements copyed into the program must 
obey the restrictions on ordering of 
statements. For example, COPY must be 
between global and local declarations in 
the macro definition or in the main program 
if the copyed text contains global and 
local declarations. 
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The typical form of a macro instruction is: 

r t t 1 

(Name J Operation! Operand | 

,. + + ) 

| A symbol, | Mnemonic J Zero to 100 (200 | 

J sequence { operation | for F assembler) j 

| symbol, or | code | operands, separated j 

j not used j (by commas j 

L A -J..— ._ J 

The name entry of the macro instruction 
may contain a symbol. The symbol will not 
be defined in the generation process unless 
a symbolic parameter appears in the name 
entry of the prototype and the same 
parameter appears in the name entry of a 
generated model statement. 

The operation entry contains the 
mnemonic operation code of the macro 
instruction. The mnemonic operation code 
must be the same as the mnemonic operation 
code of a macro definition in the source 
program or in a source statement library. 

The macro definition with the same 
mnemonic operation code is used by the 
assembler to process the macro instruction. 
Under the DOS D Assembler, 10K Variant, the 
macro definition is obtained from an inline 
programmer macro definition or from the 
system source statement library, in that 
order of precedence. Under the DOS D 
Assembler, 14K Variant, and the DOS F 
Assembler, the macro definition is obtained 
from an inline programmer macro definition, 
a private source statement library, if one 
is assigned, or the system source statement 
library, in that order of precedence. 
Under the TOS D Assembler, 10K and 14K 
Variants, the macro definition is obtained 
from an inline programmer macro definition 
or from the standard private library, in 
that order of precedence. 

The placement and order of the operands 
in the macro instruction may be determined 
by the placement and order of the symbolic 
parameters in the operand entry of the 
prototype statement . 



Macro Instruction Operands 



Any combination of up to 127 (255 for 
assembler F) characters may be used as a 
macro instruction operand provided that the 
following rules concerning apostrophes, 
parentheses, equal signs, ampersands, 
commas, and blanks are observed. 



Paired Apostrophes . An operand may contain 
one or more sequences of characters, each 
of which is enclosed within single 
apostrophes. (The sequence of characters 
itself may contain an even number of 
apostrophes.) The single apostrophes, 
which enclose the sequence of characters, 
are called paired apostrophes. 

The first sequence of characters starts 
with the first apostrophe in the operand. 
Subsequent character sequences start with 
the first apostrophe after the apostrophe 
that ends the previous sequence of 
characters . 

In the following example; there are two 
sequences of characters enclosed within 
single apostrophes. Therefore, there are 
two sets of paired apostrophes: the first 
and fourth apostrophes, and the fifth and 
sixth apostrophes. 

, A ,, B , C , D i 

An apostrophe (not within paired 
apostrophes) , immediately followed by a 
letter, and immediately preceded by the 
letter L (when L is preceded by any special 
character other than an ampersand) , is not 
considered in determining paired 
apostrophes. For instance, the apostrophe 
in the following example is not considered. 

L' SYMBOL 

•AL f SYMBOL 1 is an invalid operand. 

Paired Parentheses . There must be an equal 
number of left and right parentheses. The 
nth left parenthesis must appear to the 
left of the nth right parenthesis. 

Paired parentheses are a left 
parenthesis and a following right 
parenthesis without any other parentheses 
intervening. If there is more than one 
pair, each additional pair is determined by 
removing any pairs already recognized and 
reapplying the above rule for paired 
parentheses. For instance, in the 
following example the first and fourth, the 
second and third, and the fifth and sixth 
parentheses are each paired parentheses. 

(A (B) C) D (E) 

A parenthesis that appears between 
paired apostrophes is not considered in 
determining paired parentheses. For 
instance, in the following example the 
middle parenthesis is not considered. 
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C) *) 

Equal Signs . An equal sign can only occur 
as the first character in an operand or 
between paired apostrophes or paired 
parentheses. The following examples 
illustrate these rules. 

=F»32 I 
•C=D" 
E (F=G) 

Ampersands . Except as noted under "Inner 
Macro Instructions", each sequence of 
consecutive ampersands must be an even 
number of ampersands. The following 
example illustrates this rule. 

S&123SSSS 

Commas . A comma indicates the end of an 
operand, unless it is placed between paired 
apostrophes or paired parentheses. The 
following example illustrates this rule. 

(A,B)C',« 

Blanks . Except as noted under "Statement 
Form", a blank indicates the end of the 
operand entry, unless it is placed between 
paired apostrophes. The following example 
illustrates this rule. 

•A B C 

The following are valid macro 
instruction operands: 



SYMBOL 




A+2 


123 




(TO (8) ,FROM) 


X»189A» 




0(2,3) 


* 




=F , 4096 i 


L*NAME 




ABSS9 


•TEN = 


10' 


•PARENTHESIS IS 


•COMMA 


is ,' 


•APOSTROPHE IS' 



If this form is used, a blank does not 
always indicate the end of the operand 
entry. Furthermore, unlike the prototype 
statement, the macro instruction may have 
omitted operands; therefore consecutive 
commas may appear in the operand list, or 
comma may appear at the end of the list. 



Omitted Operands 



If an operand that appears in the prototype 
statement is omitted from the macro 
instruction, then the comma that would have 
separated it from the next operand must be 
present. If the last operand (s) is omitted 
from a macro instruction, then the comma (s) 
separating the last operand (s) from the 
next previous operand may be omitted. 

The following example shows a macro 
instruction preceded by its corresponding 
prototype statement. The macro instruction 
operands that correspond to the third and 
sixth operands of the prototype statement 
are omitted in this example. 



r T T , ., 

| Name | Operation | Operand | 

,. + + i 

j | EXAMPLE |SA,&B,£C,gD,SE,SF | 
j (EXAMPLE | 17, *+4,, AREA, FIELD (6) j 

L J. X J 






The following are invalid macro 
instruction operands: 



W'NAME 
5A)B 



(15 B) 

•ONE* IS '!• 



(odd number of apostrophes) 

(number of left parentheses 
does not equal number of 
right parentheses) 

(blank not placed between 
paired apostrophes) 

(blank not placed between 
paired apostrophes) 



Statement Form 



If the symbolic parameter that 
corresponds to an omitted operand is used 
in a model statement, a null character 
value (not a blank) replaces the symbolic 
parameter in the generated statement, i.e., 
in effect the symbolic parameter is 
removed. 

For example, the first statement below 
is a model statement that contains the 
symbolic parameter £C. If the operand that 
corresponds to €C was omitted from the 
macro instruction, the second statement 
below would be generated from the model 
statement. 



Macro instructions may be written using the 
same alternate form that can be used to 
write prototype statements. This alternate 
form is described in Section 7 under the 
subsection "Macro Instruction Prototype". 



r t t 1 

| Name | Operation | Operand | 

j. + + 4 

j JMVC |THERESC.25,THIS j 
| |MVC JTHERE25,THIS J 

L J. J. j 



.J 
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Operand Sublists 



An operand of a macro instruction may be a 
sublist. 

Sublists provide the programmer with a 
convenient way to refer to: (1) a 
collection of macro instruction operands as 
a single operand, or (2) a single operand 
in a collection of operands. 






^^ 
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A sublist consists of one or irore 
operands (subcperands) separated by commas 
and enclosed in paired parentheses. The 
entire sublist, including the parentheses, 
is considered to be one macro instruction 
operand. 



A suboperand is always treated as a 
character string. It is not possible to 
pass a suboperand containing a sublist to 
an inner macro instruction (a macro 
instruction used as a model statement in a 
iracrc definition) . The inner macro would 
regard the operand as a character string 
during generation. 





_ T — 


_ T _ 


|Name 


|Operat ion | Operand 


j. 


-4 


_4 


Header | 


| MACRO 


1 


Prototype J 


JAEDNUM 


JSNUN,SBEG,SAFEA 


Model | 


|L 


J SREG, SNUM (1) 


Model | 


|A 


J SREG, SNUM (2) 


Model j 


|A 


| SREG, SNUM (3) 


Model J 


|ST 


j SREG , SAREA 


Trailer J 

L 


JMEND 
_4 


I 

4. 


r — 


T 


t 


Macro | 


|ADDNUM 


| (A,B,C) ,6, SUM 


Generated | 


|L 


|6,A 


Generated | 


|A 


J6,B 


Generated | 


|A 


|6,C 


Generated) 


|ST 


|6,SUM 






_x 



^^p*r 






Orritted subcperands are handled in the 
same way as cititted operands. If ( ) 
appears as an operand, however, it is 
treated as a character string, not as a 
sublist with all suboperands omitted. 



If a macro instruction is written in the 
alternate statement format, each sublist 
operand may be written on a separate line; 
the macro instruction may be written on as 
many lines as there are operands, including 
sublist operands. 



The limit of 127 characters (255 for 
assembler F) applies to an entire sublist 
including suboperands, parentheses, and 
commas within these parentheses. 



If SP1 is a symbolic parameter in a 
prototype statement, and the cor re spending 
operand of a macro instruction is a 
sublist, then 6P1 (n) may be used in a model 
statement to refer to the nth operand of 
the sublist, where n may be any arithmetic 
expression allowed in a SETA instruction. 
The SETA instruction is described in 
Section 9. If SP1 is a symbolic parameter, 
and the corresponding operand of a macro 
instruction is a sublist, then SP1 refers 
to the entire sublist (including 
parentheses) . 



If the sublist notation is used, but the 
operand is not a sublist, then SF1 (1) 
refers to the operand and SP1 (2) through 
£P1(100) (SP1 (200) for assembler F) refer 
to null character value. If an operand has 
the form ( ) , it is treated as a character 
string and not as a sublist. 



For example, consider the following 
macro definition, macro instruction, and 
generated statements. 



Ihe operand of the macro instruction 
that corresponds to symbolic parameter SNUM 
is a sublist. One of the operands in the 
sublist is referred to in the operand entry 
of three of the model statements. For 
example, SNUM (1) refers to the first 
operand in the sublist corresponding to 
symbolic parameter SNUM. The first operand 
of the sublist is A. Therefore, A replaces 
SNUM (1) to form part of the generated 
statement. 

Note : When referring to an operand in a 
sublist, the left parenthesis of the 
sublist notation must immediately follow 
the last character of the symbolic 
parameter, e.g., SNUM (1) . A period should 
net be placed between the left parenthesis 
and the last character of the symbolic 
parameter. 

A period may be used between these two 
characters only when the programmer wants 
tc concatenate the left parenthesis with 
the characters that the symbolic parameter 
represents. The following example shows 
what would be generated if a period 
appeared between the left parenthesis and 
the last character of the symbolic 
parameter in the first model statement of 
the above example. 

r t t 1 

|Name |Operation|Operand | 
,. 4 + 1 

Prototype! JAEDNUM | SNUM, SREG, SAREA j 
Model J JL j SREG, SNUM. (1) | 

Macro | IABDNUM j (A,B,C) ,6, SUM | 

Generated) |L J6, (A,B,C) (1) j 

1 1 x J 

The symbolic parameter SNUM is used in 
the operand entry of the model statement. 
The characters (A,B,C) of the macro 
instruction correspond to SNUM. Since SNUM 
is immediately followed by a period, SNUM 
and the period are replaced by (A,E,C) . 
The period does not appear in the generated 
statement. The resulting generated 
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statement is an invalid assembler language 
statement. 



Inner Macro Instructions 



A rracro instruction may be used as a model 
statement in a macro definition. Macro 
instructions used as model statements are 
called inner macro instructions. 



A macro instruction that is not used as 
a model statement is referred to as an 
cuter macro instruction. 



Any symbolic parameters used in an inner 
macro instruction are replaced by the 
corresponding operands of the outer macro 
instruction. 



The macro definition corresponding to an 
inner macro instruction is used to generate 
the statements that replace the inner macro 
instruction. 



The ADDNUM macro instruction of the 
previous example is used as an inner macrc 
instruction in the following example. 



The inner macro instruction contains two 
symbolic parameters, SS and ST. The 
characters (X,Y,Z) and J of the macro 
instruction correspond to SS and ST, 
respectively. Therefore, these characters 
replace the symbolic parameters in the 
operand entry of the inner macro 
instruction. 



The assembler then uses the macro 
definition that corresponds to the inner 
macro instruction to generate statements to 
replace the inner macro instruction. The 
fourth through seventh generated statements 
have been generated for the inner macro 
instruction. 







T 


T ~ 1 




|NameJOperat ion J Operand j 




h 


-4 


_ + .j 


Header 




JMACRO 




Prototype 




JCOMP 


| SR1,SR2,SS,ST,6U | 


Model 




|SR 


|SR1,SR2 j 


Model 




|C 


| SR 1 , ST | 


Model 




|BNE 


|6U J 

-■+ 1 1 

|SS,12,STj | 

|SR1,ST | 


Inner 




JADENUM 


Model 


SU 


|A 


Trailer 




JMEND 
| MACRO 








| ADDNUM 


| SNUM,SREG,SAREA | 






|L 


| SREG,SNUM (1) J 






|A 


j SREG,SNUM(2) J 






jA 


jSREG,SNUM(3) j 






j ST 


|SREG,SAREA | 






JMEND 









-f 


_ + 1 


Outer 


K 




JCOMP 
|SR 


110,11, (X,Y,Z) ,J,K| 
|10,11 | 


Generated 


Generated 




jc 


|10,J i 


Generated 




|BNE 


JK | 
_4 , J 

|12,X | | 


Generated 




|L 


Generated 




|A 


M2,Y | | 


Generated 




|A 


|12,Z | | 


Generated 




J ST 


J 12, J | | 
_j. j i 






T 1 


Generated 


K 


|A 


|10,J | 




L_ _ 


± 


± J 


Note: An 


ampersand that is part of a 



o 






symbolic parameter is not considered in 
determining whether a macro instruction 
operand contains an even number cf 
consecutive ampersands. 



Levels of Macro Instructions 



A macro definition that corresponds to an 
outer macro instruction may contain any 
number cf inner macro instructions. The 
outer macro instruction is called a first 
level macro instruction. Each of the inner 
macro instructions is called as second 
level macro instruction. 

Ihe macro definition that corresponds to 
a second level macro instruction may 
contain any number of inner macro 
instructions. These macro instructions are 
called third level macro instructions, etc. 

Ihe number of levels of macrc 
instructions that may be used depends upon 
the complexity of the macro definition and 
the amount of storage available. This is 
described in detail in Appendix B. 
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Section 9. How to Write Conditional Assembly Instructions 



O 



The conditional assembly instructions allow 
the programmer to: (1) define and assign 
values to SET symbols that can be used to 
vary parts of generated statements, and (2) 
vary the sequence of generated statements. 
Thus, the programmer can use these 
instructions to generate many different 
sequences of statements from the same macro 
definition. 

There are 13 conditional assembly 
instructions, 10 of which are described in 
this section. The other three conditional 
assembly instructions — GBLA, GBLB, and 
GBLC — are described in Section 10. The 
instructions described in this section are: 



LCLA SETA AIF 
LCLB SETB AGO 
LCLC SETC ACTR 



ANOP 



The primary use of the conditional 
assembly instructions is in macro 
definitions. However, all of them may be 
used in an assembler language source 
program. 

Where the use of an instruction outside 
macro definitions differs from its use 
within macro definitions, the difference is 
described in the subsequent text. 

The LCLA, LCLB, and LCLC instructions 
are used to define and assign initial 
values to local SET symbols. 

The SETA, SETB, and SETC instructions 
may be used to assign arithmetic, binary, 
and character values, respectively, to SET 
symbols. The SETB instruction is described 
after the SETA and SETC instructions, 
because the operand of the SETB instruction 
is a combination of the operands of the 
SETA and SETC instructions. 



SET Symbols 



SET symbols are one type of variable 
symbol. The symbolic parameters discussed 
in Section 7 are another type of variable 
symbol. SET symbols differ from symbolic 
parameters in three ways: (1) where they 
can be used in an assembler language source 
program, (2) how they are assigned values , 
and (3) how the values assigned to them can 
be changed. 

Symbolic parameters can only be used in 
macro definitions, whereas SET symbols can 
be used inside and outside macro 
definitions. 

SET symbols are assigned values by SETA, 
SETB, and SETC conditional assembly 
instructions and by local or global 
declarations. 

Each symbolic parameter is assigned a 
single value for one use of a macro 
definition, whereas the values assigned to 
each SETA, SETB, and SETC symbol are not so 
restricted. 



DEFINING SET SYMBOLS 



SET symbols must be defined by the 
programmer before they are used. When a 
SET symbol is defined it is assigned an 
initial value. SET symbols may be assigned 
new values by means of the SETA, SETB, and 
SETC instructions. A SET symbol is defined 
when it appears as an operand of an LCLA, 
LCLB, or LCLC instruction. 



o 



The AIF, AGO, and ANOP instructions may 
be used in conjunction with sequence 
symbols to vary the sequence in which 
statements are assembled. The programmer 
can test attributes assigned by the 
assembler to symbols or macro instruction 
operands to determine which statements are 
to be processed. The ACTR instruction may 
be used to limit the number of AIF and AGO 
branches executed in any assembly. 

Examples illustrating the use of 
conditional assembly instructions are 
included throughout this section. A chart 
summarizing the elements that can be used 
in each instruction appears at the end of 
this section. 



USING VARIABLE SYMBOLS 



The SETA, SETB, and SETC instructions may 
be used to change the values assigned to 
SETA, SETB, and SETC symbols, respectively. 
When a SET symbol appears in the name or 
operand entry of a statement, the current 
value of the SET symbol (i.e. , the last 
value assigned to it) replaces the SET 
symbol in the statement, when a SETC 
symbol appears in the operation entry of a 
statement, the current value of the SETC 
symbol replaces the Set symbol in the 
statement . 
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For example, if SA is a symbolic 
parameter, and the corresponding characters 
of the macro instruction are the symbol 
HERE, then HERE replaces each occurrence of 
SA in the macro definition. However, if SA 
is a SET symbol, the value assigned to SA 
can be changed, and a different value can 
replace various occurrences of SA in the 
macro definition. 

The same variable symbol may not be used 
as a symbolic parameter and as a SET symbol 
in the same macro definition. 

The following illustrates this rule. 

r 1 1 1 

| Name | Operation! Operand | 

j. + f ) 

JSNAME j MOVE |ST0,SFR0M j 

I JL J. J 



is used in the operand entry of a macro 
instruction, and the value assigned to the 
SET symbol is in the form of sublist 
notation, the operand is not considered a 
sublist. 



Attributes 



The assembler assigns attributes to macro 
instruction operands and to symbols in the 
program. These attributes may be referred 
to only in conditional assembly 
instructions . 



There are six kinds of attributes, 
are: type, length, scaling, integer, 
count, and number. 



They 






If the statement above is a prototype 
statement, then 6NAME, STO, and 6FR0M may 
not be used as SET symbols in the macro 
definition. 

The same variable symbol may not be used 
as two different types of SET symbols in 
the same macro definition. Similarly, the 
same variable symbol may not be used as two 
different types of SET symbols outside 
macro definitions. 

For example, if SA is a SETA symbol in a 
macro definition, it cannot be used as a 
SETC symbol in that definition, Similarly, 
if SA is a SETA symbol outside macro 
definitions, it cannot be used as a SETC 
symbol outside macro definitions. 

The same variable symbol if declared 
local may be used in two or more macro 
definitions and outside macro definitions. 
If such is the case, the variable symbol 
will be considered a different variable 
symbol each time it is used. 

For example, if SA is a variable symbol 
(either SET symbol or symbolic parameter) 
in one macro definition, it can be used as 
a variable symbol (either SET symbol or 
symbolic parameter) in another definition. 
Similarly, if SA is a variable symbol (SET 
symbol or symbolic parameter) in a macro 
definition, it can be used as a SET symbol 
outside macro definitions. 



If an outer macro instruction operand is 
a symbol before substitution, then the 
attributes of the operand are the same as 
the corresponding attributes of the symbol. 
The symbol must appear in the name entry of 
an assembler language statement or be an 
external symbol. The statement must be 
outside macro definitions and must not 
contain any variable symbols. 

If an inner macro instruction operand is 
a symbolic parameter, then attributes of 
the operand are the same as the attributes 
of the corresponding outer macro 
instruction operand. 

Each attribute has a notation associated 
with it. The notations are: 



Attribute 


Notation 


Type 


T' 


Length 


L* 


Scaling 


S* 


Integer 


I' 


Count 


K* 


Number 


N« 



If a macro instruction operand is a 
sublist, the programmer may refer to the 
attributes of either the sublist or each 
operand in the sublist. The type, length, 
scaling, and integer attributes of a 
sublist are the same as the corresponding 
attributes of the first operand in the 
sublist. 



/0\ 



All variable symbols may be concatenated 
with other characters in the same way as 
symbolic parameters. The rules for 
concatenation are in Section 7 under the 
subsection "Model Statements." 

Variable symbols in macro instructions 
are replaced by the values assigned to 
them, immediately prior to the start of 
processing the definition. If a SET symbol 



All the attributes of macro instruction 
operands may be referred to in conditional 
assembly instructions within macro 
definitions. However, only the type, 
length, scaling, and integer attributes of 
symbols may be referred to in conditional 
assembly instructions outside macro 
definitions. Symbols appearing in the name 
entry of generated statements are not 
assigned attributes. 
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The programmer may refer to an attribute 
in the following ways: 

1. In a statement that is outside macro 
definitions, he may write the notation 
for the attribute immediately followed 
by a symbol. (E.g., T'NAME refers to 
the type attribute of the symbol 
NAME.) 

2. In a statement that is in a macro 
definition, he may write the notation 
for the attribute immediately followed 
by a symbolic parameter. (E.g., L* 
6NAME refers to the length attribute 
of the characters in the macro 
instruction that correspond to 
symbolic parameter SNAME; L' SNAME (2) 
refers to the length attribute of the 
second operand in the sublist that 
corresponds to symbolic parameter 
SNAME.) 



TYPE ATTRIBUTE (T*) 



The type attribute of a macro instruction 
operand or a symbol is a letter. 

The programmer may refer to a type 
attribute in the operand of a SETC 
instruction, or in character relations in 
the operands of SETB or AIF instruction, or 
in other instructions where use of the 
character is valid. 

The following letters are used for 
symbols that name DC and DS statements and 
for outer macro instruction operands that 
are symbols that name DC or DS statements. 

A A-type address constant, implied 

length, aligned. 
B Binary constant. 
C Character constant. 
D Long floating-point constant, 

implied length, aligned. 
E Short floating-point constant, 

implied length, aligned. 
F Fullword fixed- point constant, 

implied length, aligned. 
G Fixed-point constant, explicit 

length. 
H Half word fixed- point constant, 

implied length, aligned. 
K Floating-point constant, explicit 

length. 
L Extended floating-point constant, 

implied length, aligned. 
P Packed decimal constant. 
R A-, S-, V-, or Y-type address 

constant, explicit length. 
S S-type address constant, implied 

length, aligned. 
V V-type address constant, implied 

length, aligned. 



X Hexadecimal constant. 

Y Y-type address constant, implied 

length, aligned. 
Z Zoned decimal constant. 

The following letters are used for 
symbols (and outer macro instruction 
operands that are symbols) that name 
statements other than DC or DS statements, 
or that appear in the operand field of an 
EXTRN or WXTRN statement. 

I Machine instruction 

J Control section name 

M Macro instruction 

T EXTRN symbol 

W CCW instruction 

$ WXTRN symbol 

The following letters are used for inner 
and outer macro instruction operands only. 

N Self-defining term 
Omitted operand 

The letter U (Undefined) is used for 
inner and outer macro- instruction operands 
that cannot be assigned any of the above 
letters. The type attribute of all 
literals appearing as macro instruction 
operands is U. This also is true for inner 
macro instruction operands that are 
ordinary symbols or variable symbols. 
Because the attributes are not available at 
the necessary time, this letter is also 
assigned to symbols that name EQU and LTORG 
statements, to any symbols occurring more 
than once in the name entry of source 
statements, and to all symbols naming DC 
and DS statements with expressions or 
variable symbols as modifiers. The type 
attribute also is undefined when the 
modifier expression consists solely of 
self -defining terms. 

The attributes of A, B, C, and D in the 
following examples are undefined: 



DC 
DC 
DC 
DC 



3FL(A-B) '15 
(A-B)F , 15 i 
SX* 1 ' 
FL(3-2) •!■ 



LENGTH (L«) , SCALING (S') , AND INTEGER (I*) 
ATTRIBUTES 



The length, scaling, and integer attributes 
of macro instruction operands and symbols 
are numeric values. 

The length attribute of a symbol (or of 
a macro instruction operand that is a 
symbol) is as described in Part 1 of this 
publication. Reference to the length 
attribute of a variable symbol is illegal 
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except for symbolic parameters in SETA, 
SETB, and AIF statements. If the basic L* 
attribute is desired, it can be obtained as 
follows : 



&A 
SB 



SETC 'Z* 
SETC •L ,, » 
MVC SA. (6BSA) ,X 
After generation, this would result in 
MVC Z (L'Z) ,X 

Reference must not be made to the length 
attributes of symbols or macro instruction 
operands whose type attributes are the 
letters M, N, 0, T, $, orU. 

Scaling and integer attributes are 
provided for symbols that name fixed-point, 
floating-point, and decimal DC or DS 
statements . 

Fixed and Floating Point . The scaling 
attribute of a fixed point or floating 
point number is the value given by the 
scale modifier. The integer attribute is a 
function of the scale and length attributes 
of the number. 

Decimal . The scaling attribute of a 
decimal number is the number of decimal 
digits to the right of the decimal point. 
The integer attribute of a decimal number 
is the number of decimal digits to the left 
of the decimal point. 

Scaling and integer attributes are 
available for symbols and macro instruction 
operands only if their type attributes are 
H, F, and G (fixed point) ; D, E, K, and L 
(floating point) ; or P and Z (decimal) . 

The programmer may refer to the length, 
scaling, and integer attributes in the 
operand field of a SETA instruction, or in 
arithmetic relations in the operand fields 
of SETB or AIF instructions. 



replace the variable symbols, rather than 
the variable symbols, are used to determine 
the count attribute. 

The programmer may refer to the count 
attribute in the operand field of a SETA 
instruction, or in arithmetic relations in 
the operand fields of SETB and AIF 
instructions that are part of a macro 
definition. 



NUMBER ATTRIBUTE (N*) 



The programmer may refer to the number 
attribute of macro instruction operands 
only. 

The number attribute is a value equal to 
the number of operands in an operand 
sublist. The number of operands in an 
operand sublist is equal to one plus the 
number of commas that indicate the end of 
an operand in the sublist. 

The following examples illustrate this 
rule. 



(A,B,C,D,E) 

(A,,C,D,E) 

(A,B,C,D) 

(,B,C,D,E) 

(A,B,C,D,) 

(A,B,C,D,,) 



operands 
operands 
operands 
operands 
operands 
operands 



If the macro instruction operand is not 
a sublist, the number attribute is one. If 
the macro instruction operand is omitted, 
the number attribute is zero. 

The programmer may refer to the number 
attribute in the operand field of a SETA 
instruction, or in arithmetic relations in 
the operand fields of SETB and AIF 
instructions that are part of a macro 
definition. 






COUNT ATTRIBUTE (K') 



ASSIGNING INTEGER ATTRIBUTES TO SYMBOLS 



The programmer may refer to the count 
attribute of macro instruction operands 
only. 

The count attribute is a value equal to 
the number of characters in the macro 
instruction operand after substituting for 
variable symbols, excluding commas. If the 
operand is a sublist, the count attribute 
includes the beginning and ending 
parentheses and the commas within the 
sublist. The count attribute of an omitted 
operand is zero. 

If a macro instruction operand contains 
variable symbols, the characters that 



The integer attribute is computed from the 
length and scaling attributes. 

Fixed Point . The integer attribute of a 
fixed-point number is equal to eight times 
the length attribute of the number minus 
the scaling attribute minus one; i.e., 
I»=8*L*-S , -1. 

Each of the following statements defines 
a fixed-point field. The length attribute 
of HALFCON is 2, the scaling attribute is 
6, and the integer attribute is 9. The 
length attribute of ONECON is 4, the 
scaling attribute is 8, and the integer 
attribute is 23. 



y 
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r t t- t 

^\,. | Name | Operation | Operand | 

****** JHALFCONJDC |HS6 , -25.93 I J 

JONECON |DC JFS8 1 100.3E-2 i | 

l x x „ , j 



Floating Point : The integer attribute of a 
type D or E floating-point number is equal 
to two times the difference between the 
length attribute of the number and one, 
minus the scaling attribute; i.e., 
I'=2* (L«-1) -S*. 

Because of its low order characteristic, 
the integer attribute of a type L constant 
with a length greater than 8 bytes is two 
less than the value indicated in the 
formula above. The integer attribute of a 
type L constant with a length of 8 bytes or 
less is the same as the value indicated in 
the formula above. 



Sequence Symbols 



The name entry of a statement may contain a 
sequence symbol. Sequence symbols provide 
the programmer with the ability to vary the 
sequence in which statements are processed 
by the assembler. 



A sequence symbol is used in the operand 
entry of an AIF or AGO statement to refer 
to the statement named by the sequence 
symbol. 



A sequence symbol may be used in the 
name entry of any statement that does not 
contain a symbol or SET symbol, except a 
prototype statement, or a MACRO, LCLA, 
LCLB, LCLC, GBLA, GBLB, GBLC, ACTR, ICTL, 
ISEQ, or COPY instruction. 



4^\ 



Each of the following statements defines 
a floating-point value. The length 
attribute of SHORT is 4, the scaling 
attribute is 2, and the integer attribute 
is 4. The length attribute of LONG is 8, 
the scaling attribute is 5, and the integer 
attribute is 9. 

r t t 1 

| Name J Operation | Operand | 

|. x + ., 

|SHORT | DC |ES2 , 46.415* j 

[LONG | DC |DS5 , -3.729' | 

L - X X J 



A sequence symbol consists of a period 
followed by one through seven letters 
and/or digits, the first of which must be a 
letter. 



The following are valid sequence 
symbols: 



READER 


.A23456 


LOOP 2 


.X4F2 


N 


.S4 



Decimal : The integer attribute of a packed 
decimal number is equal to two times the 
length attribute of the number minus the 
scaling attribute minus one; i.e., 
I'=2*L , -S , -1. The integer attribute of a 
zoned decimal number is equal to the 
difference between the length attribute and 
the scaling attribute; i.e., I , =L'-S". 

Each of the following statements defines 
a decimal field. The length attribute of 
FIRST is 2, the scaling attribute is 2, and 
the integer attribute is 1 . The length 
attribute of SECOND is 3, the scaling 
attribute is 0, and the integer attribute 
is 3. The length attribute of THIRD is 4, 
the scaling attribute is 2, and the integer 
attribute is 2. The length attribute of 
FOURTH is 3, the scaling attribute is 2, 
and the integer attribute is 3. 



o 



r t~ ' t 

j Name | Ope ration { Operand 

I- + 

j FIRST j DC 
j SECOND J DC 
j THIRD | DC 
| FOURTH j DC 
l X 



Ip' + i^s' 

|Z'-543 i 
IZ'79.68' 

.x 



The following are invalid sequence 
symbols : 



CARDAREA (first character is not a 

period) 
.246B (first character after 

period is not a letter) 
.AREA2456 (more than seven characters 

after period) 
.BCDJ584 (contains a special 

character other than initial 

period) 
.IN AREA (contains a special 

character, i.e., blank, 

other than initial period) 



If a sequence symbol appears in the name 
entry of a macro instruction, and the 
corresponding prototype statement contains 
a symbolic parameter in the name entry, the 
sequence symbol does not replace the 
symbolic parameter wherever it is used in 
the macro definition. 



The following example illustrates this 
rule. 
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Name 



"T ' T 

| Operation J Operand 



J. 

1 


-t 

j MACRO 


— + 

I 


.J 


1 j SNAME 


| MOVE 


|STO,SFROM 




2 | SNAME 


| ST 


|2,SAVEAREA 




I 


|L 


|2,6FROM 




I 


| ST 


|2,STO 




I 


|L 


|2,SAVEAREA 




I 


| MEND 


I 




L 


.j. „_. 














| 3J.SYM 

L 


| MOVE 

.4 


|FIELDA,FIELDB 

__j 


j 


r 


T 


_.j._ 


— — .j 


«l 


| ST 


|2,SAVEAREA 




I 


|L 


|2,FIELDB 




I 


| ST 


| 2, FIELD A 




I 


|L 


| 2 , SAVEAREA 













The symbolic parameter SNAME is used in 
the name entry of the prototype statement 
(statement 1) and the first model statement 
(statement 2) . In the macro instruction 
(statement 3) a sequence symbol (.SYM) 
corresponds to the symbolic parameter 
SNAME. SNAME is not replaced by .SYM, and, 
therefore, the generated statement 
(statement 4) does not contain a name 
entry. 



LCLA, LCLB, LCLC --Define SET Symbols 



The typical form of these instruction is: 



I Name 



T T 

| Operation | Operand 



I- 

(Not used, | LCLA, |One or more variable 

j must not j LCLB, or j symbols, that are 
j be | LCLC | to be used as SET 
j present | {symbols, separated 
| | jby commas 



The LCLA, LCLB, and LCLC instructions 
are used to define and assign initial 
values to SETA, SETB, and SETC symbols, 
respectively. The SETA, SETB, and SETC 
symbols are assigned the initial values of 
0, 0, and null character value, 
respectively. 

The programmer should not define any SET 
symbol whose first four characters are 
SSYS. 

All LCLA, LCLB, or LCLC instructions in 
a macro definition must appear immediately 
after the prototype statement and all GBLA, 
GBLB or GBLC instructions. All LCLA, LCLB, 
or LCLC instructions outside macro 
definitions must appear after all macro 
definitions in the source program, after 
all GBLA, GBLB, and GBLC instructions 
outside macro definitions, before all 



conditional assembly instructions, and 
punch and RE PRO statements outside macro 
definitions, and before the first control 
section of the program. 



SETA- Set Arithmetic 



The SETA instruction may be used to assign 
an arithmetic value to a SETA symbol. The 
form of this instruction is: 



r T T ^ 1 

| Name | Operation | Operand | 

j. + + 1 

J A SETA jSETA jA SETA arithmetic | 
| symbol j j expression j 

l X J. J 

The expression in the operand entry is 
evaluated as a signed 32-bit arithmetic 
value which is assigned to the SETA symbol 
in the name entry. The minimum and maximum 
allowable values of the expression are -2 3 * 
and +2 31 -1, respectively. 

The expression may consist of one term 
or an arithmetic combination of terms. The 
terms that may be used alone or in 
combination with each other are 
self -defining terms, variable symbols, and 
the length, scaling, integer, count, and 
number attributes. Self -defining terms are 
described in Part 1 of this publication. 

Note : A SETC variable symbol may appear in 
a SETA expression only if the value of the 
SETC variable is one to eight decimal 
digits. The decimal digits will be 
converted to a positive arithmetic value. 

The arithmetic operators that may be 
used to combine the terms of an expression 
are + (addition) , - (subtraction) , * 
(multiplication) , and / (division) . 

An expression may not contain two terms 
or two operators in succession, nor may it 
begin with an operator. 

The following are valid operand fields 
of SETA instructions: 



SAREA+X^D* 
S BETA* 10 
L"SHERE+32 



I'SN/25 

SEXIT-S'SENTRY+1 
29 



The following are invalid operand fields 
of SETA instructions: 



SAREAX*C' 
SFIELD+- 
-S DELTA* 2 
*+32 

NAME/ 15 



(two terms in succession) 
(two operators in succession) 
(begins with an operator) 
(begins with an operator; 
two operators in succession) 
(NAME is not a valid term) 
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EVALUATION OF ARITHMETIC EXPRESSIONS 



Using SETA Sym bols 



^Hfok &*' 



The procedure used to evaluate the 
arithmetic expression in the operand of a 
SETA instruction is the same as that used 
to evaluate arithmetic expressions in 
assembler language statements. The only 
difference between the two types of 
arithmetic expressions is the terms that 
are allowed in each expression. 



The following evaluation procedure is 
used: 



The arithmetic value assigned to a SETA 
symbol is substituted for the SETA syirbcl 
when it is used in an arithmetic relation. 
If the SETA symbol is not used in an 
arithmetic expression, the arithmetic value 
is completely converted to an unsigned 
integer, with leading zeros removed. If 
the value is zero, it is converted to a 
single zero. 



The following example illustrates this 
rule: 






1. Each term is given its numerical 
value. 



2. The arithmetic operations are 

performed moving from left to right. 
However, multiplication and/or 
division are performed before addition 
and subtraction. 



The computed result is the value 
assigned to the SETA symbol in the 
name entry. 



The arithmetic expression in the operand 
entry of a SETA instruction may contain one 
or more sequences of arithmetically 
combined terms that are enclosed in 
parentheses. A sequence of parenthesized 
terms may appear within another 
parenthesized sequence. 



| Name 


{Operation {Operand 


L 


_j. 


L 


r — — 


| MACRO 


— j. 


JSNAME 


| MOVE 


|STC,6FR0M 




|LCLA 


|6A,SB,6C,SD 


1 |&A 


| SETA 


1 10 


2JSE 


| SETA 


1 12 


3|6C 


| SETA 


| 6A- SB 


4|SE 


| SETA 


| 6A* SC 


| SNAME 


| ST 


| 2, SAVE AREA 


5| 


|L 


|2,SFRCN6C 


6| 


| ST 


|2,STC£D 




i^ 


|2,SAVEAREA 


L 


|MEND 

__L 


L 


r 


T 


— F — — - 


| HERE 

L 


jMOVE 
_j.__ 


|FIEIDA,FIELDB 

i 


r — 


T — 


T 


| HERE 


| ST 


|2,SAVEAREA 




|L 


J2,FIELDB2 




| ST 


|2,FIELDA8 




|L 


|2,SAVEAREA 



o 



The following are examples of SETA 
instruction operands that contain 
parenthesized sequences of terms. 

(L« 6HERE+32) *29 

SAREA+X' 2E*/ (SEXIT-S 1 6ENTRY+ 1) 

SEETA*10* (I , S/25/(SEXIT-S , 6ENTRY+1)) 

The parenthesized portion or portions of 
an arithmetic expression are evaluated 
before the rest of the terms in the 
expression are evaluated. If a sequence of 
parenthesized terms appears within another 
parenthesized sequence, the innermost 
sequence is evaluated first. 

The SETA arithmetic expression can only 
have five levels of parentheses. The 
parentheses required in subscripting, 
substring, and sublist notation count when 
determining these levels. A counter is 
maintained for each SETA statement and 
increased by one for each occurrence of a 
variable symbol as well as the operation 
entry. The maximum value this counter may 
attain is 35. (See Appendix H) . 



Statements 1 and 2 assign to the SETA 
symbols SA and SB the arithmetic value /10 
and +12, respectively. Therefore, 
statement 3 assigns the SETA symbol 6C the 
arithmetic value -2. When SC is used in 
statement 5, the arithmetic value -2 is 
converted to the unsigned integer 2. When 
SC is used in statement 4, however, the 
arithmetic value -2 is used. Therefore, SE 
is assigned the arithmetic value +8. When 
SD is used in statement 6, the arithmetic 
value -»-8 is converted to the unsigned 
integer 8. 



The following example shows how the 
value assigned to a SETA symbol iray be 
changed in a macro definition. 
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r t t 

|Naire | Operation! Operand 



r 7 t 

J Name J Operat ion J Operand 



k 


j MACRO 


_- f 


|gNAME 


JMOVE 


| STO , 6FROM 




|LCLA 


| gA 


|gA 


JSETA 


|5 


J gNAME 


|ST 


| 2, SAVEAREA 




|L 


| 2 , gFROMgA 


| SA 


|SETA 


|8 




|ST 


| 2,gTOgA 




II* 


| 2 , SAVEAREA 


L 


|MEND 
-J. ^.- -— 


j.,_ 


r 

|HERE 

L 


-f T- — 

|MOVE 
_j. 


— 1— — 

|FIELDA,FIELDB 
j 


r 

JHERE 


T — 

JST 


| 2, SAVEAREA 




|L 


|2,FIELDB5 




|ST 


|2,FIELDA8 




|L 


| 2 , SAVEAREA 



l X 4. J 



Statement 1 assigns the arithmetic value 
+5 to SETA symbol gA. In statement 2, 6A 
is converted to the unsigned integer 5. 
Statement 3 assigns the arithmetic value +8 
to 6A. In statement *4, therefore, SA is 
converted to the unsigned integer 8, 
instead of 5. 



J. 

I 


-i 

j MACRO 


I 


-! 


11 


|ADDX 


|gNUMEER,gREG 




I 


| LCLA 


| gLAST 




2 | gLAST 


|SETA 


|K»gNUMEER 




I 

3| 

I 

I 

i 


|A 
JST 
jMEND 
_j. _ _ 


|gREG,gMJMEER(1) 

j gREG, gNUMEER (fiLAST) 

|gREG,gNUMEER(1) 

I 
__j. _ ____ 


j 


r 

L 


T 

JADEX 
_j. 


| (A,B,C,D,E) ,3 

_ j.— — — 


-j 

j 


r — 
1 


T 

IL- 


|3,A 


n 


1 


IA 


|3,E 




1 


JST 


|3,A 













gNUMEER is the first symbolic parameter 
in the operand entry of the prototype 
statement (statement 1) . The corresponding 
characters, (A,E,C,D,E) , of the macro 
instruction (statement 4) are a sublist. 
Statement 2 assigns to gLAST the arithmetic 
value +5, which is equal to the number of 
operands in the sublist. Therefore, in 
statement 3, gNUMBER (gLAST) is replaced by 
the fifth operand of the sublist. 



I 1 



A SETA symbol may be used with a 
symbolic parameter to refer to an operand 
in an operand sublist. If a SETA symbol is 
used for this purpose it must have been 
assigned a value in the range 1 to 100. 



Any expression that may be used in the 
operand of a SETA instruction may be used 
to refer to an operand in an operand 
sublist. 



Sublists are described in Section 8 
under "Operand Sublists. 1 * 



The following macro definition may be 
used to add the last operand in an cperand 
sublist to the first operand in an operand 
sublist and store the result at the first 
operand. A sample macro instruction and 
generated statements follow the macro 
definition. 



SETC- Set Character 



The SETC instruction is used to assign a 
character value to a SETC symbol. The form 
of this instruction is: 

r r t 1 

| Name J Operation) Cperand | 

j. a 4 1 

|A SETC JSETC |Cne operand, cf j 
j symbol j jthe form described j 
j | J below j 

l JL -I ====—. J 

The operand may consist of the type 
attribute, a character expression, a 
substring notation, or a concatenation of 
substring notations and character 
expressions. A SETA symbol may appear in 
the cperand of a SETC statement. The 
result is the character representation of 
the decimal value, unsigned, with leading 
zercs removed. If the value is zero, one 
decimal zero is used. 






TYPE ATTRIBUTE 



The character value assigned to a SETC 
symbol may be a type attribute. If the 
type attribute is used, it must appear 
alone in the operand field. The following^ 



fxampxe^assxgns^to^fhe SETC symbol gTYPE 
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o 






the letter that is the type attribute of 
the macro instruction operand that 
corresponds to the symbolic parameter gABC. 



r t t 1 

| Name | Operation | Operand | 

j. x x ^ 

jgTYPE JSETC JT'gABC | 

L X X J 



o 



CHARACTER EXPRESSION 



A character expression consists of any 
combination of characters enclosed in 
apostrophes. The maximum length of a 
character expression is 127 characters - 

The character value enclosed in 
apostrophes in the operand field is 
assigned to the SETC symbol in the name 
entry. The maximum length character value 
that can be assigned to a SETC symbol is 
eight characters. If a value greater than 
8 is specified, the leftmost 8 characters 
will be used. 



EVALUATION OF CHARACTER EXPRESSIONS ; The 
following statement assigns the character 
value ABJU to the SETC symbol &ALPHA: 



r t t 1 

| Name | Operation | Operand | 

j. + x . 4 

j&ALPHA JSETC |*ABX4 I | 

I X .-X ^— . J 

More than one character expression may 
be concatenated into a single character 
expression by placing a period between the 
terminating apostrophe of one character 
expression and the opening apostrophe of 
the next character expression. For 
example, either of the following statements 
may be used to assign the character value 
ABCDEF to the SETC symbol 6BETA. 

r t t 1 

{Name | Operation j Operand j 

j. x x— . 4 

jgBETA JSETC j 'ABCDEF* j 

| gBETA | SETC | * ABC • . « DEF' | 

L X X J 

Two apostrophes must be used to 
represent a apostrophe that is part of a 
character expression. 

The following statement assigns the 
character value L' SYMBOL to the SETC symbol 
6LENGTH. 



r t t 1 

| Name | Operation | Operand J 

•. x x 1 

JgLENGTHlSETC I , L* * SYMBOL* | 

I X X J 

Variable symbols may be concatenated 
with other characters in the operand field 
of a SETC instruction according to the 
general rules for concatenating variable 
symbols with other characters (see Section 
7). 

If 6ALPHA has been assigned the 
character value ABJ54, either of the 
following statements may be used to assign 
the character value ABX4RST to the variable 
symbol S GAMMA. 



T T 

Name | Operation j Operand 
x x 

SGAMMA j SETC j ■ gALPHA.RST* 

X X 

T T 

Name J Operation | Operand 
x x 

g DELTA j SETC j • g ALPHA* . ' RST 

X X 



Two ampersands must be used to represent 
an ampersand that is not part of a variable 
symbol. Both ampersands become part of the 
character value assigned to the SETC 
symbol. They are not replaced by a single 
ampersand . 

The following statement assigns the 
character value HALFgg to the SETC symbol 
gAND. 

r T T . - ., 

| Name | Operation J Operand | 

j. x.™ x _ 1 

| gAND j SETC | ■ HALFg g ■ j 

t X X J 

In this example, 

r T T 1 

| Name | Operation | Operand | 

j. x + - 1 

jgA JSETC j •ggBETA* (2,5) | 

I -X X J 

•ggBETA* (2,5) produces gBETA which is 
considered a character string, not a 
variable symbol. 



SUBSTRING NOTATION 



The character value assigned to a SETC 
symbol may be a substring character value. 
Substring character values permit the 
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programmer to assign part of a character 
value to a SETC symbol. 

If the programmer wants to assign part 
of a character value to a SETC symbol, he 
must indicate to the assembler in the 
operand of a SETC instruction: (1) the 
character value itself, and (2) the part of 
the character value he wants to assign to 
the SETC symbol. The concatenation of (1) 
and (2) in the operand of a SETC 
instruction is called a substring notation. 
The character value that is assigned to the 
SETC symbol in the name entry is called a 
substring character value. 

Substring notation consists of a 
character expression, immediately followed 
by two arithmetic expressions that are 
separated from each other by a comma and 
are enclosed in parentheses. These 
parentheses count when determining the 
number of levels of parentheses. The two 
arithmetic expressions may be any 
expression that is allowed in the operand 
of a SETA instruction. They may not be 
zero. 

The first expression indicates the first 
character (in the character expression) 
that is to be assigned to the SETC symbol 
in the name entry. The second expression 
indicates the number of consecutive 
characters in the character expression 
(starting with the character indicated by 
the first expression) that are to be 
assigned to the SETC symbol. If a 
substring specifies more characters than 
are in the character string, only the 
number of available characters will be 
supplied. If the first expression 
specifies a larger number than the number 
of characters in the character expression, 
a null string will be the result. 

The maximum size character expression 
the substring character value can be chosen 
from is 127 characters. 

The following are valid substring 
notations: 

gALPHA* (2,5) 

*AB%4* (gAREA+2,1) 

• gALPHA ■ . • RST * (6 , SA) 

* ABC gGAMMA* (6A, SAREA+2) 

The following are invalid substring 
notations: 

•gBETA* (4,6) 

(blanks between character value and 
arithmetic expressions) 
*L** SYMBOL* (142-gXYZ) 

(only one arithmetic expression) 
*AB% 4 gALPHA* (8 SFIELD+2) 

(arithmetic expressions not separated by 



a comma) 
*BETA*4,6 

(arithmetic expressions not enclosed in 
parentheses) 
•gALPHA* (2,4) (1,1) 

(double substring notation is not 
permitted) 



CONCATENATING SUBSTRING NOTATIONS AND 
CHARACTER EXPRESSIONS : Substring notations 
may be concatenated with character 
expressions in the operand of a SETC 
instruction. If a substring notation 
follows a character expression, the two may 
be concatenated by placing a period between 
the terminating apostrophe of the character 
expression and the opening apostrophe of 
the substring notation. 

For example, if gALPHA has been assigned 
the character value AB%4, and gBETA has 
been assigned the character value ABCDEF, 
then the following statement assigns gGAMMA 
the character value AB%4BCD. 

r T T ., 

J Name | Operation | Operand | 

j. + x ^ 

| gGAMMA j SETC j • gALPHA* . • gBETA" (2,3) j 
l_ X X J 

If a substring notation precedes a 
character expression or another substring 
notation, the two may be concatenated by 
writing the opening apostrophe of the 
second item immediately after the closing 
parenthesis of the substring notation. 

The programmer may optionally place a 
period between the closing parenthesis of a 
substring notation and the opening 
apostrophe of the next item in the operand. 

If gALPHA has been assigned the 
character value AB5S4, and gABC has been 
assigned the character value 5RS, either of 
the following statements may be used to 
assign gWORD the character value ABX45RS. 

r t r 1 

| Name | Operation | Operand j 

f. x x 1 

j g WORD j SETC j * gALPHA ■ ( 1 , 4) ■ gABC ■ j 
J gWORDJ SETC j • gALPHA* (1,4)* gABC* (1,3) j 

l X X J 

If a SETC symbol is used in the operand 
of a SETA instruction, the character value 
assigned to the SETC symbol must be one to 
eight decimal digits. 

If a SETA symbol is used in the operand 
of a SETC statement, the arithmetic value 
is converted to an unsigned integer with 
leading zeros removed. If the value is 
zero, it is converted to a single zero. 
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Using SETC Symbols 



The character value assigned to a SETC 
symbol is substituted for the SETC symbol 
when it is used in the name, operation, or 
operand of a statement. 

For example, consider the following 
macro definition, macro instruction, and 
generated statements. 



j Name j Operation! Operand 



t 


-t 

j MACRO 


_, + 


l&NAME 


| MOVE 


|STO,SFROM 




ILCLC 


| S PREFIX 


1 | 6PREFIX | SETC 


| •FIELD* 


|SNAME 


| ST 


| 2, SAVE AREA 


2| 


|L 


|2,SPREFIX6FROM 


3| 


| ST 


|2,SPREFIX&T0 




|L 


|2,SAVEAREA 




| MEND 




L 


_X-— 


j 


r — 


T 


T 


| HERE 
t — — 


| MOVE 
_j __ 


|A,B 
__j _ _ 


r 


T 


1 — — 


| HERE 


[ST 


|2,SAVEAREA 




|L 


|2,FIELDB 




| ST 


|2,FIELDA 




|L 


| 2, SAVE AREA 









Statement 1 assigns the character value 
FIELD to the SETC symbol 6 PREFIX. In 
statements 2 and 3, SPREFIX is replaced by 
FIELD. 

The following example shows how the 
value assigned to a SETC symbol may be 
changed in a macro definition. 



I Name 



*T T 

| Operation | Operand 



,. x x ., 





| MACRO 




SNAME 


| MOVE 


|STO,SFROM 




ILCLC 


| SPREFIX 


SPREFIX | SETC 


| 'FIELD 1 


SNAME 


| ST 


| 2, SAVE AREA 




|L 


| 2,6 PREFIX &FROM 


gPREFIX| SETC 


| •AREA* 




| ST 


|2,SPREFIX&TO 




|L 


|2,SAVEAREA 




| MEND 






4 


__X 


HERE 


| MOVE 


|A,B 




.+ 


__X 


HERE 


| ST 


| 2, SAVE AREA 




|L 


|2,FIELDB 




| ST 


|2,AREAA 




|L 


|2,SAVEAREA 



L X X J 

Statement 1 assigns the character value 
FIELD to the SETC symbol SPREFIX. 
Therefore, SPREFIX is replaced by FIELD in 
statement 2. Statement 3 assigns the 



character value AREA to 6 PREFIX. 
Therefore, 6 PREFIX is replaced by AREA, 
instead of FIELD, in statement 4. 

The following example illustrates the 
use of a substring notation as the operand 
field of a SETC instruction. 



Name 



h 



•T T 

| Operation | Operand 



| MACRO 
&NAME j MOVE 

|LCLC 
& PREFIX | SETC 
8NAME j ST 

|L 

| ST 

|L 

I MEND 



|&TO,£FROM 

| 6PREFIX 

| 'gTO 1 (1,5) 

|2,SAVEAREA 

|2,&PREFIXgFR0M 

| 2 , 6TO 

|2,SAVEAREA 



HERE 



I MOVE 



|FIELDA,B 



HERE 



| ST 

j ST 

.J. 



|2,SAVEAREA 
|2,FIELDB 
|2,FIELDA 
j 2 , SAVEAREA 



Statement 1 assigns the substring 
character value FIELD (the first five 
characters corresponding to symbolic 
parameter 6T0) to the SETC symbol 6PREFIX. 
Therefore, FIELD replaces 6PREFIX in 
statement 2 . 



SETB-Set Binary 



The SETB instruction may be used to assign 
the binary value or 1 to a SETB symbol. 
The form of this instruction is: 



r t t 1 

| Name | Operation | Operand j 

y + + ^ 

jA SETB JSETB JA or a 1,(0) or (1) j 
| symbol j jor a logical ex- j 
j | jpression enclosed in j 
j j | parentheses j 

t x x J 

The operand may contain a or a 1 or a 
logical expression enclosed in parentheses 
(No explicit binary zeros or ones are 
allowed in parentheses other than in the 
form (0) or (1) .) A logical expression is 
evaluated to determine if it is true or 
false; the SETB symbol in the name entry is 
then assigned the binary value 1 or 
corresponding to true or false, 
respectively . 

Note : The parentheses enclosing a logical 
expression do not count towards the 
parenthesis level limit. 
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A logical expression consists of one 
term or a logical combination of terms. 
The terms that may be used alone or in 
combination with each other are arithmetic 
relations, character relations, and SETB 
symbols. The logical operators used to 
combine the terms of an expression are AND, 
OR, and NOT. 

A logical expression may not contain two 
terms in succession. A logical expression 
may contain two operators in succession 
only if the first operator is either AND or 
OR and the second operator is NOT. A 
logical expression may begin with the 
operator NOT. It may not begin with the 
operators AND or OR. 

An arithmetic relation consists of two 
arithmetic expressions connected by a 
relational operator. A character relation 
consists of two character strings connected 
by a relational operator. The relational 
operators are EQ (equal) , NE (not egual) , 
LT (less than) , GT (greater than) , LE (less 
than or equal) , and GE (greater than or 
equal) . 

Any expression that may be used in the 
operand of a SETA instruction, may be used 
as an arithmetic expression in the operand 
of a SETB instruction. Anything that may 
be used in the operand of a SETC 
instruction, may be used as a character 
string in the operand of a SETB 
instruction. This includes substring and 
type attribute notations. The maximum size 
of the character values that can be 
compared is 127 characters. If the two 
character values are of unequal length, 
then the shorter one will always compare 
less than the longer one, regardless of the 
characters present. 

The relational and logical operators 
must be immediately preceded and followed 
by at least one blank or other special 
character. Each relation may or may not be 
enclosed in parentheses. If a relation is 
not enclosed in parentheses, it must be 
separated from the logical operators by at 
least one blank or other special character. 

The following are valid operand fields 
of SETB instructions: 



SB (not enclosed in parentheses) 
(T*SP12 EQ "F" SB) 

(two terms in succession) 
(•ABX<*« EQ 'ALPHA* NOT SB) 

(the NOT operator must be preceded by 
AND or OR) 
(AND T*SP12 EQ 'F') 

(expression begins with AND) 



Evaluation of Logical Expressions 



The following procedure is used to evaluate 
a logical expression in the operand field 
of a SETB instruction: 

1. Each term (i.e., arithmetic relation, 
character relation, or SETB symbol) is 
evaluated and given its logical value 

(true or false) . 

2. The logical operations are performed 
moving from left to right. However, 
NOTs are performed before ANDs, and 
ANDs are performed before ORs. 

3. The computed result is the value 
assigned to the SETB symbol in the 
name field. 

The logical expression in the operand of 
a SETB instruction may contain one or more 
sequences of logically combined terms that 
are enclosed in parentheses. A sequence of 
parenthesized terms may appear within 
another parenthesized sequence. 

The following are examples of SETB 
instruction operands that contain 
parenthesized sequences of terms. 

(NOT (SB AND SAREA+X^D* GT 29)) 
(SB AND(T'SP12 EQ'F'OR 6B) 

The parenthesized portion or portions of 
a logical expression are evaluated before 
the rest of the terms in the expression are 
evaluated. If a sequence of parenthesized 
terms appears within another parenthesized 
sequence, the innermost sequence is 
evaluated first. 






1 

(SAREA+2 GT 29) 

('ABX4* EQ ■SALPHA") 

(T'SABC NE TSXYZ) 

(T f 6Pl2 EQ *F«) 

(6AREA+2 GT 29 OR SB) 

(NOT SB AND SAREA+X'2D' GT 29) 

( , gC , EQ , MB i ) 

The following are invalid operand fields 
of SETB instructions: 



Logical expressions may have only five 
levels of parentheses. Subscripting, 
substring notation, and logical expression 
nesting count when determining the level of 
parentheses. The parentheses surrounding 
the SETB operand do not count. A counter 
is maintained for each statement and is 
increased by one for each occurrence of a 
variable symbol and an operation entry. 
The maximum value this counter may attain 
is 35. See Appendix H. 
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Using SETE Symbols 



AIF-Conditional Branch 



The logical value assigned to a SETE symbol 
is used for the SETE symbol appearing in 
the operand of an AIF instruction or 
another SETB instruction. 



The AIF instruction is used to alter 
conditionally the sequence in which source 
program statements are processed by the 
assembler. The typical form of this 
instruction is: 



If a SETB symbol is used in the operand 
of a SETA instruction, or in arithmetic 
relations in the operands of AIF and SETE 
instructions, the binary values 1 (true) 
and (false) are converted to the 
arithmetic values +1 and +0, respectively. 



If a SETB symbol is used in the operand 
of a SETC instruction, in character 
relations in the operands of AIF and SETB 
instructions, or in any other statement, 
the binary values 1 (true) and (false) , 
are converted to the character values 1 and 
0, respectively. 



The following example illustrates these 
rules. It is assumed that L'STO EQ 4 is 
true, and S'STO EQ is false. 



I Name 



| Name 

L 


| Operation | Operand 
_j J. 


r 


t 

j MACRO 


T 


| SNAME 


| MOVE 


| STO , 6 FROM 




|LCLA 


| 6A1 




JLCLB 


| SB1,6B2 




|LCLC 


|6C1 


J SB1 


| SETB 


| (L'STO EQ 4) 


|£B2 


| SETB 


| (S^TO EQ 0) 


|SA1 


| SETA 


| SB1 


|SC1 


| SETC 


| , SB2' 


| SNAME 


| ST 


| 2,SAVEAREA 




|L 


| 2,SFR0MSA1 




| ST 


| 2,STOSC1 




|L 


| 2 , SAVEAREA 




| MEND 




|. 

| HERE 


j MOVE 

.J. 


_ f _ 

|FIELDA,FIELDB 


| HERE 


T 
JST 


| 2 , SAVEAREA 




|L 


| 2,FIELDB1 




| ST 


| 2,FIELDA0 




|L 


| 2, SAVEAREA 






Because the operand of statement 1 is 
true, 6B1 is assigned the binary value 1. 
Therefore, the arithmetic value +1 is 
substituted for SE1 in statement 3. 
Eecause the operand of statement 2 is 
false, SB2 is assigned the binary value 0. 
Therefore, the character value is 
substituted for 6E2 in statement 4. 



[ 

| Sequence | AIF 
| symbol j 
j or not j 
j used j 

I I 



"T T 

J Operation | Operand 



JA logical expression 
| enclosed in paren- 
j theses, immediately 
j followed by a 
| sequence symbol 

-JL 



Any logical expression that may be used 
in the operand Of a SETE instruction may be 
used in the operand of an AIF instruction. 
However, the forms 

AIF (0) , sequence symbol and 
AIF (1) , sequence symbol 

are invalid. The sequence symbol in the 
operand must immediately follow the closing 
parenthesis of the logical expression. AIF 
operand entries must not contain explicit 
zeros or ones. 

Note : The parentheses enclosing the 
logical expression do not count toward the 
level limit. 

The logical expression in the operand is 
evaluated to determine if it is true or 
false. If the expression is true, the 
statement named by the sequence symbol in 
the operand is the next statement processed 
by the assembler; however, sequence 
checking is not affected ■. If the 
expression is false, the next sequential 
statement is processed by the assembler. 

The statement named by the sequence 
symbol may precede or follow the AIF 
instruction. 

If an AIF instruction is in a macro 
definition, then the sequence symbol in the 
operand must appear in the name entry of a 
statement in the definition. If an AIJF 
instruction appears outside macro 
definitions, then the sequence symbol in 
the operand must appear in the name entry 
of a statement outside macro definitions. 

The following are valid operands of AIF 
instructions: 

(6AREA+X'2D* GT 29) .READER 
(T*&P12 EQ 'F') .THERE 

The following are invalid operands of 
AIF instructions : 
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(T'SAEC NE T*£XYZ) (no sequence symbol) 
. X4F2(no logical expression) 
(T'SABC NE T*SXYZ) .X4F2 (blanks between 
logical expression and sequence symbol) 

The following macro definition may be 
used to generate the statements needed to 
move a fullword fixed-point number from one 
storage area to another. The statements 
will be generated only if the type 
attribute of both storage areas is the 
letter F. 



r 7 t 1 

J Name JOperat ion (Operand J 

y + 4 { 

| Sequence JAGO |A sequence symbol | 
j symbol or j j j 

jnot used j j j 

l a a r j 



The statement named by the sequence 
symbcl in the operand is the next statement 
processed by the assembler. 



o 



I Name 



SN 



SN 



.END 



"T 1 

| Operation! Operand 



J MACRO 
| MOVE 
|AIF 
JAIF 
j ST 

1 1, 
j ST 

|L 

JMEND 
.X 



j ST , SF 

| (T'6T NE T*6F) .END 

j (T'ST NE 'F') .END 

| 2,SAVEAREA 

|2,£F 

j 2, ST 

| 2,SAVEAREA 



The statement named by the sequence 
symbol may precede or follow the AGO 
instruction. 

If an AGO instruction is part of a macro 
definition, then the sequence symbol in the 
operand must appear in the name entry of a 
statement that is in that definition. If 
an AGO instruction appears outside macro 
definitions, then the sequence symbol in 
the operand must appear in the name entry 
of a statement outside macro definitions. 



The logical expression in the operand cf 
statement 1 has the value true if the type 
attributes of the two macro instruction 
operands are not equal. If the type 
attributes are equal, the expression has 
the logical value false. 

Therefore, if the type attributes are 
not equal, statement 4 (the statement named 
by the sequence symbol .END) is the next 
statement processed by the assembler. If 
the type attributes are equal, statement 2 
(the next sequential statement) is 
processed. 

The logical expression in the operand of 
statement 2 has the value true if the type 
attribute of the first macro instruction 
operand is not the letter F. If the type 
attribute is the letter F, the expression 
has the logical value false. 

Therefore, if the type attribute is not 
the letter F, statement 4 (the statement 
named by the sequence symbol .END) is the 
next statement processed by the assembler. 
If the type attribute is the letter F, 
statement 3 (the next sequential statement) 
is processed. 



Ihe following example illustrates the 
use of the AGO instruction. 



r- — -7 — 


T ~ ~ 


l 


|Name (Operation JOperand 


1 


L l 


J. 


— — J 


r — — r — 


^ _ 


I 


| | MACRO 






|SNAME |M0VE 


|*T,SF 




1| |AIF 


| (T*£T EC 'F*) .FIRST 




2 | | AGO 


J.END 




3 |. FIRST JAIF 


| (T'ST NE T' 6F) .END 




JSNAME | ST 


| 2, SAVE AREA 




I |L 


|2,6F 




I I si 


|2,6T 




I |L 


|2,SAVEAREA 




4|.ENE |MEND 






I J. _ 


J. _ 





Statement 1 is u 
type attribute of t 
instruction operand 
the type attribute 
statement 3 is the 
by the assembler, 
net the letter F, s 
statement processed 



sed to determine if the 
he first macrc 

is the letter F. If 
is the letter F, 
next statement processed 
If the type attribute is 
tatement 2 is the next 

by the assembler. 



Statement 2 is used to indicate to the 
assembler that the next statement to be 
processed is statement 4 (the statement 
named by sequence symbol . END) . 



o 



AGO-Unconditional Branch 



The AGO instruction is used to 
unconditionally alter the sequence in which 
source program statements are processed by 
the assembler. The typical form of this 

i nst- rnpfi r>n i c » 



ACTR-Conditional Assembly Loop Counter 



The ACTP instruction is used to limit the 
number of AGO and A IF branches executed 
within a macro definition or within the 



taxn isroaiTA^G junnjtp 
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A separate ACTR statement may be used in 
each macro definition and in the main 
program. These counters are independent. 

The form of this instruction is: 

r t t ' 1 

| Name | Operation! Operand | 

,. j. f 1 

| Not used, | ACTR |Any valid SETA | 
jirust not j J expression | 
J be present j j j 

l l j J 

This statement must immediately follow 
any global or local declarations, if any. 
This statement causes a counter to be set 
to the value in its operand. Each time an 
AGO cr AIF branch is executed, the counter 
is decremented by one. If the count is 
zero before decrementing, the assembler 
takes one of two actions: 

1. If a macro definition is being 
processed, the processing of it and 
any macros above it in a nest is 
terminated, and the next statement in 
the main portion of the prograrr is 
processed. 

2. If the main portion of the program is 
being processed, conditional assembly 
is terminated, and the portion of the 
program generated so far is assembled. 

If an ACTR statement is not given, the 
assumed value of the counter is 150 for the 
E assembler and 4096 for the F assembler. 



ANOP- Assembly No -Operation 



The ANOP instruction facilitates 
conditional and unconditional branching to 
statements named by symbols or variable 
symbols . 

The typical form of this instruction is: 



before the statement and then branch to the 
ANOP instruction. This has the same effect 
as branching to the statement immediately 
after the ANCF instruction. 

The following example illustrates the 
use of the ANOP instruction. 



r r t t 

J Name | Operation |Cperand J 

j. 4 + .| 



6NAME 



STYPE 

.FTYPE 

SNAME 



MACRO 




MOVE 


ST,SF 


LCLC 


STYPE 


AIF 


(T'ST Eg 


SETC 


t E t 


ANOP 




STSTYPE 


2, SAVE AREA 


L STYPE 


2,SF 


STSTYPE 


2, ST 


LSTYPE 


2,SAVEAREA 


MEND 





EC 'F') .FTYPE 



t L L J 

Statement 1 is used to determine if the 
type attribute of the first macro 
instruction operand is the letter F. If 
the type attribute is not the letter F, 
statement 2 is the next statement processed 
by the assembler. If the type attribute is 
the letter F, statement 4 should be 
processed next. However, since there is a 
variable symbol (SNANE) in the name field 
of statement 4, the required sequence 
symbol. (.FTYFE) cannot be placed in the 
name field. Therefore, an ANOP instruction 
(statement 3) roust be placed before 
statement 4. 

Then, if the type attribute of the first 
operand is the letter F, the next statement 
processed by the assembler is the statement 
named by sequence symbol .FTYPE. The value 
of STYPE retains its initial null character 
value because the SETC instruction is not 
processed. Since .FTYPE names an ANOP 
instruction, the next statement processed 
by the assembler is statement 4, the 
statement following the ANOP instruction. 






r t t 1 

|Name (Operation! Operand | 

,. f f ^ 

(Sequence | ANOP |Not used, must not | 
| symbol j jbe present | 

i x j. J 

If the programmer wants to use an AIF or 
AGO instruction to branch to another 
statement, he must place a sequence symbol 
in the name entry of the statement to which 
he wants to branch. However, if the 
programmer has already entered a symbol cr 
variable symbol in the name entry of that 
statement, he cannot place a sequence 
symbol in the name entry. Instead, the 
programmer must place an ANOP instruction 



Conditional Assembly Elements 



The following chart summarizes the elements 
that can be used in each conditional 
assembly instruction. Each row in this 
chart indicates which elements can be used 
in a single conditional assembly 
instruction. Each column is used to 
indicate the conditional assembly 
instructions in which a particular element 
can be used. 

The intersection of a column and a row 
indicates whether an element can be used in 
an instruction, and if so, in what fields 
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of the instruction the element can be used. indicates that symbolic parameters can te 
For example, the intersection of the first used in the operand field of SETA 
row and the first column of the chart instructions. 



S.P. 



SETS 
I" 

SETC 



SETA 



AIF 
AGO 



Variable Symbols 



4 4 -4 4 4 4 4 4 4 4 4 1 



SET Symbols 



1 T — 

SETA | SETB j SETC 
L f 



H" 



N,0 



N,0 



03 



4 4 4 4 4 4 4 ^ 



N,0 



T 1 

-Attributes 4 i 



t t ir t t 

T' J L' j S* I I" J K* J N' 
4 4 4 4 4 







0* 



4 4 4 4 4 4 4 4 4 4 4 



a 



oa 



a 



4 4 4 4 4 4 4 1 



a 



4 4 4 4 4 4 4 < 



c a 



C a 



C a 



C a 



-H 

s.s 



N,C 
N,0 



ANOP I I I I I J I I I j I K 
J. 4 4 4 4 4 4 4 4 4 4 4 4 

ACTR |0 |0 |0 I 03 J J I I I C J C J 
X i. L J. J. X _J. J Jl J J 



1 Only in character relations 

2 Only in arithmetic relations 

3 Only if one to eight decimal digits 

Abbreviations 



N Is Name L* is Length Attribute K* is Count Attribute 

O is Operand S* is Scaling Attribute N* is Number Attribute 

S.P. is Symbolic 1* is Integer Attribute S.S. is Sequence Symbol 
j Parameter 

L .. 






'•■h^j^'' 
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Section 10. Additional Features 



C:, 



The additional features of the assembler 
language allow the programmer to: 

1 . Terminate processing of a macro 
definition. 

2. Generate error messages. 

3. Define global SET symbols. 

4. Define subscripted SET symbols. 

5. Use system variable symbols - 

6. Prepare keyword and mixed-mode macro 
definitions and write keyword and 
mixed- mode macro instructions. 



MEXIT-Macro Definition Exit 



The MEXIT instruction is used to indicate 
to the assembler that it should terminate 
processing of a macro definition. The 
typical form of this instruction is: 

r t t '-i 

| Name | Operation | Operand | 

y x x _ H 

| Sequence | MEXIT |Not used, | 

j symbol orj jmust not be | 

j not used j j present j 

i _x x J 

The MEXIT instruction may only be used 
in a macro definition. 

If the assembler processes an MEXIT 
instruction that is in a macro definition 
corresponding to an outer macro 
instruction, the next statement processed 
by the assembler is the next statement 
outside macro definitions. 



The following example illustrates the 
use of the MEXIT instruction. 



r t t 

| Name | Operation | Operand 

j. x + 



&NAME 



.OK 
£NAME 



MACRO 
JMOVE 
JAIF 
| MEXIT 
JANOP 
| ST 
|L 
|ST 

j MEND 
-X 



6T,SF 
(T* ST EQ 'F') .OK 



2,SAVEAREA 

2,SF 

2, ST 

2 , SAVEAREA 



L X X J 

Statement 1 is used to determine if the 
type attribute of the first macro 
instruction operand is the letter F. If 
the type attribute is the letter F, the 
assembler processes the remainder of the 
macro definition starting with statement 3. 
If the type attribute is not the letter F r 
the next statement processed by the 
assembler is statement 2. Statement 2 
indicates to the assembler that it is to 
terminate processing of the macro 
definition. 



MNOTE Statement 



The MNOTE instruction may be used to 
generate a message and to indicate what 
error severity code, if any, is to be 
associated with the message. The severity 
code is for the programmer's information 
only and is not used by the DOS assembler 
or control program. The typical form of 
this instruction is: 



o 



If the assembler processes an MEXIT 
instruction that is in a macro definition 
corresponding to a second or third level 
macro instruction, the next statement 
processed by the assembler is the next 
statement after the second or third level 
macro instruction in the macro definition, 
respectively. 

MEXIT should not be confused with MEND. 
MEND indicates the end of a macro 
definition. MEND must be the last 
statement of every macro definition, 
including those that contain one or more 
MEXIT instructions. 



r t t 1 

| Name | Operation] Operand | 

,. x x 1 

| Sequence | MNOTE |See examples below. | 
| symbol orj j j 

| not used j j | 

l X X J 

The operand entry of the MNOTE assembler 
instruction may be written in one of the 
following forms : 

1. severity code, 'message* 

2. ,'message' 
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3. 'message 1 



For 2 and 3 above, the severity code is 
assumed to be one. 



The MNOTE instruction may only be used 
in a macro definition. Variable symbols 
may be used to generate the MNOTE mnemonic 
operation code, the severity code 
indicator, and the message. 

The resulting severity code indicator 
may be a decimal integer to 255, blank, 
or an asterisk. The integers indicate the 
severity of the error. (0 is the least 
severe; 255 is the most severe) . If the 
severity code indicator is blank or 
omitted, 1 is assumed. If the severity 
code is an asterisk, the MNOTE is not 
considered an error message. Messages can 
be generated with substitution using 
variable symbols. 

The MNOTE statement appears in the 
listing with a statement number at the 
point where it was generated. It appears 
even if PRINT NOGEN is specified. If the 
severity code indicator was an integer or a 
blank, this statement number is placed in a 
list of statement numbers of MNOTE and 
other error statements near the end of the 
assembly listing. If the severity code is 
an asterisk, the statement number is not 
placed in this list. 

Since the message portion of the MNOTE 
operand is enclosed in apostrophes, two 
apostrophes must be used to represent a 
single apostrophe. Any variable symbols 
used in the message operand are replaced by 
values assigned to them. Two ampersands 
must be used to represent a single 
ampersand that is not part of a variable 
symbol . 

The following example illustrates the 
use of the MNOTE instruction. 











Name 


j Operation J Operand 


1 




-+ 


.__ + 


.| 




j MACRO 






SNAME 


| MOVE 


|ST,SF 






|AIF 


j (T*ST NE T'SF) .M1 






|AIF 


| (T'ST NE 'F*) .M2 




SNAME 


| ST 


|2,SAVEAREA 






|L 


|2,£F 






{ST 


j 2 , ST 






|L 


|2,SAVEAREA 






j MNOTE 


|*,*MOVE GENERATED* 






| MEXIT 






.M1 


j MNOTE 
j MEXIT 


|8, f TYPE NOT SAME' 




.M2 


J MNOTE 
| MEND 


|8, f TYPE NOT F' 













Statement 1 is used to determine if the 
type attributes of both macro instruction 
operands are the same. If they are, 
statement 2 is the next statement processed 
by the assembler. If they are not, 
statement 5 is the next statement processed 
by the assembler. Statement 5 causes an 
error message — 8, TYPE NOT SAME — to be 
printed in the source program listing. 

Statement 2 is used to determine if the 
type attribute of the first macro 
instruction operand is the letter F. If 
the type attribute is the letter F, 
statement 3 is the next statement processed 
by the assembler. If the attribute is not 
the letter F, statement 6 is the next 
statement processed by the assembler. 
Statement 6 causes an error message — 8, TYPE 
NOT F — to be printed in the source program 
listing. Statement 4 is an MNOTE which is 
not treated as an error message. 



Global and Local Variable Symbols 



The following are local variable symbols: 

1. Symbolic parameters. 

2. Local SET symbols. 

3. System variable symbols. 

Global SET symbols are the only global 
variable symbols. 

The GBLA, GBLB, and GBLC instructions 
define global SET symbols, just as the 
LCLA, LCLB, and LCLC instructions define 
the SET symbols described in Section 9. 
Hereinafter, SET symbols defined by LCLA, 
LCLB, and LCLC instructions will be called 
local SET symbols. 

Global SET symbols may communicate 
values between statements in one or more 
macro definitions and statements outside 
macro definitions. However, local SET 
symbols communicate values between 
statements in the same macro definition, or 
between statements outside macro 
definitions. 

If a local SET symbol is defined in two 
or more macro definitions, or in a macro 
definition and outside macro definitions, 
the SET symbol is considered to be a 
different SET symbol in each case. 
However, a global SET symbol is the same 
SET symbol each place it is defined. 

A SET symbol must be defined as a global 
SET symbol in each macro definition in 
which it is to be used as a global SET 
symbol. A SET symbol must be defined as a 
global SET symbol outside macro 
definitions, if it is to be used as a 



i_> 






100 Part 3: Conditional Assembly and Macro Facilities 



Page of GC24-3414-9 
Revised Nov. 31, 1972 
By TNL- GN33-8157 



global SET symbol outside macro 
definitions. 

If the same SET symbol is defined as a 
global SET symbol in one or more places, 
and as a local SET symbol elsewhere, it is 
considered the same symbol wherever it is 
defined as a global SET symbol, and a 
different symbol wherever it is defined as 
a local SET symbol. 



All GBLA, GBLB, and GBLC instructions in 
a macro definition must appear before all 
LCLA, LCLB, and LCLC instructions in that 
macro definition. All GBLA, GBLB, and GBLC 
instructions outside macro definitions must 
appear before all LCLA, LCLB, and LCLC 
instructions outside macro definitions. 
Comments statements are the only statements 
which may be interspersed with the 
definitions of local and global SET 
symbols. 



DEFINING LOCAL AND GLOBAL SET SYMBOLS 



USING GLOBAL AND LOCAL SET SYMBOLS 



Local SET symbols are defined when they 
appear in the operand entry of an LCLA, 
LCLB, or LCLC instruction. These 
instructions are discussed in Section 9 
under "Defining SET Symbols." 

Global SET symbols are defined when they 
appear in the operand entry of a GBLA, 
GBLB, or GBLC instruction. The typical 
forms of these instructions are: 



I Name 



I- 



■T T 

j Operation | Operand 



| Not used, 
must not 
be present 



GBLA, 
GBLB, or 
GBLC 



jOne or more 

| variable 

j symbols that are 

| to be used as 

| global SET 

{symbols, sepa- 

| rated by commas 



The GBLA, GBLB, and GBLC instructions 
define global SETA, SETB, and SETC symbols, 
respectively, and assign the same initial 
values as the corresponding types of local 
SET symbols. However, a global SET symbol 
is assigned an initial value by only the 
first GBLA, GBLB, or GBLC instruction 
processed in which the symbol appears. 
Subsequent GBLA, GBLB, or GBLC instructions 
processed by the assembler do not affect 
the value assigned to the SET symbol. 

The programmer should not define any 
global SET symbols whose first four 
characters are SSYS. 



The following examples illustrate the use 
of global and local SET symbols. Each 
example consists of two parts. The first 
part is an assembler language source 
program. The second part shows the 
statements that would be generated by the 
assembler after it processed the statements 
in the source program. 

Example 1 : This example illustrates how 
the same SET symbol can be used to 
communicate (1) values between statements 
in the same macro definitions, and (2) 
different values between statements outside 
macro definitions. 



r t t 1 

| Name | Operation | Operand | 

j. + + .] 





| MACRO 




6 NAME 


| LOADA 






|LCLA 


SA 


SNAME 


|LR 


15, SA 


SA 


|SETA 
|MEND 


SA+1 




J LCLA 


SA 


FIRST 


| LOADA 






|LR 


15, SA 




| LOADA 






|LR 


15, SA 




|END 
-4. — J 


FIRST 

L _ _ _ 




T 


— _ 


FIRST 


|LR 


15,0 




|LR 


15,0 




|LR 


15,0 




|LR 


15,0 




|END 


FIRST 



L J. J J 



If a GBLA, GBLB, or GBLC instruction is 
part of a macro definition, it must 
immediately follow the prototype statement, 
or another GBLA, GBLB, or GBLC instruction. 
GBLA, GBLB, and GBLC instructions outside 
macro definitions must appear after all 
macro definitions in the source program, 
before all conditional assembly 
instructions and PUNCH and REPRO statements 
outside macro definitions, and before the 
first control section of the program. 



SA is defined as a local SETA symbol in 
a macro definition (statement 1) and 
outside macro definitions (statement 4) . 
SA is used twice within macro definition 
(statements 2 and 3) and twice outside 
macro definitions (statements 5 and 6) . 

Since SA is a local SETA symbol in the 
macro definition and outside macro 
definitions, it is one SETA symbol in the 
macro definition, and another SETA symbol 
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outside macro definitions. Therefore, 
statement 3 (which is in the macro 
definition) does not affect the value used 
for SA in statements 5 and 6 (which are 
outside macro definitions) . 

Example 2 ; This example illustrates how a 
SET symbol can be used to communicate 
values between statements that are part of 
a macro definition and statements outside 
macro definitions. 



r t t 

| Name | Operation | Operand 



J. 


■+ 


__X 




j MACRO 




|SNAME 


| LOADA 






jGBLA 


|SA 


|SNAME 


|LR 


| 15, SA 


|SA 


|SETA 
| MEND 


|SA+1 




|GBLA 


|SA 


| FIRST 


| LOADA 






|LR 


| 15,SA 




| LOADA 






|LR 


| 15,SA 




|END 

-X — — 


| FIRST 

_ X — _ — — 


r " 


T 


t 


| FIRST 


|LR 


I 15,0 




|LR 


I 15,1 




|LR 


I 15,1 




|LR 


I 15,2 




|END 


| FIRST 



L X X J 

SA is defined as a global SETA symbol in 
a macro definition (statement 1) and 
outside macro definitions (statement U) . 
SA is used twice within the macro 
definition (statements 2 and 3) and twice 
outside macro definitions (statements 5 and 
6) . 

Since SA is a global SETA symbol in the 
macro definition and outside macro 
definitions, it is the same SETA symbol in 
both cases. Therefore, statement 3 (which 
is in the macro definition) affects the 
value used for SA in statements 5 and 6 
(which are outside macro definitions) . 

Example 3 : This example illustrates how 
the same SET symbol can be used to 
communicate: (1) values between statements 
in one macro definition, and (2) different 
values between statements in a different 
macro definition. 



SA is defined as a local SETA symbol in 
two different macro definitions (statements 
1 and 4) . SA is used twice within each 
macro definition (statements 2, 3, 5, and 
6). 

Since SA is a local SETA symbol in each 
macro definition, it is one SETA symbol in 
one macro definition, and another SETA 
symbol in the other macro definition. 
Therefore, statement 3 (which is in one 
macro definition) does not affect the value 
used for SA in statement 5 (which is in the 
other macro definition) . Similarly, 
statement 6 does not affect the value used 
for SA in statement 2. 



r T T 

| Name | Oper at ion j Operand 



j. 


.X 

| MACRO 


__X 


|SNAME 


| LOADA 






|LCLA 


|SA 


|SNAME 


|LR 


|15,SA 


|SA 


| SETA 
| MEND 

| MACRO 
| LOADB 


|SA+1 




|LCLA 


|SA 




|LR 


| 15, SA 


|SA 


| SETA 
| MEND 


|SA+1 


| FIRST 


| LOADA 
| LOADB 
| LOADA 
| LOADB 




L_ __ _ 


| END 
.X 


| FIRST 
_ x 


r — 


T — 


T 


| FIRST 


|LR 


I 15,0 




|LR 


J 15,0 




|LR 


1 15,0 




|LR 


| 15,0 


I 


| END 


| FIRST 



l X X . J 
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Example 4 ; This example illustrates how a 
SET symbol can be used to communicate 
values between statements that are part of 
two different macro definitions. 



I Name 



h 



"T T 

| Operation | Operand 





j MACRO 




l&NAME 


| LOADA 






j GBLA 


SA 


|SNAME 


|LR 


15, SA 


|SA 


| SETA 
j MEND 

| MACRO 
| LOADB 


SA+1 




JGBLA 


SA 




|LR 


15, SA 


|SA 


|SETA 
JMEND 


SA+1 


| FIRST 


| LOADA 
j LOADB 
| LOADA 
j LOADB 






|END 


FIRST 


t - 


-4- — - J 


L ^_ _ _ _ 




T 1 


r — ~ 


| FIRST 


|LR 


15,0 




|LR 


15,1 




|LR 


15,2 




|LR 


15,3 




| END 


FIRST 
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SA is defined as a global SETA symbol in 
two different macro definitions (statements 
1 and 4) . SA is used twice within each 
macro definition (statements 2 e 3, 5, and 
6). 



Since SA is a global SETA symbol in each 
macro definition, it is the same SETA 
symbol in each macro definition. 
Therefore, statement 3 (which is in one 
macro definition) affects the value used 
for SA in statement 5 (which is in the 
other macro definition) . Similarly, 
statement 6 affects the value used for SA 
in statement 2. 



Since SA is a global SETA symbol in each 
macro definition, it is the same SETA 
symbol in each macro definition. However, 
since SA is a local SETA symbol outside 
macro definitions, it is a different SETA 
symbcl outside macro definitions. 

Therefore, statement 3 (which is in one 
macro definition) affects the value used 
for SA in statement 5 (which is in the 
ether macro definition) , but it does not 
affect the value used for SA in statements 
8 and 9 (which are outside macro 
definitions) . Similarly, statement 6 
affects the value used for SA in statement 
2, but it does not affect the value used 
for SA in statements 8 and 9. 



o 



%J 



Example 5 : This example illustrates how 
the same SET symbol can be used tc 
communicate: (1) values between statements 
in two different macro definitions, and (2) 
different values between statements outside 
macro definitions. 



r t t 

| Name | Operation! Operand 





| MACRO 




| SNAME 


I LOADA 






JGBLA 


SA 


| SNAME 


|LR 


15,SA 


JSA 


| SETA 
| MEND 

j MACRO 
| LOADB 


SA+1 




|GBLA 


SA 




|LR 


15,SA 


| SA 


| SETA 
j MEND 


SA+1 




|LCLA 


SA 


J FIRST 


j LOADA 
j LOADB 






|LR 


15, SA 




| LOADA 






j LOADB 






|LR 


15, SA 


L 


j END 
.j. __ j 


FIRST 

L _ 


r — 


t 1 


| _ _ 


j FIRST 


|LR 


15,0 




|LR 


15,1 




|LR 


15,0 




|LR 


15,2 




|LR 


15,3 




|LR 


15,0 




| END 


FIRST 



SA is defined as a global SETA symbol in 
two different macro definitions (statements 
1 and 4) , but it is defined as a local SETA 
symbol outside macro definitions (statement 
7) . SA is used twice within each macro 
definition and twice outside macro 
definitions (statements 2, 3, 5, 6, 8, and 
9). 



SUBSCRIPTED SET SYMBOLS 



Eoth global and local SET symbols may be 
defined as subscripted SET symbols. The 
local SET symbols defined in Section 9 were 
all nonsubscripted SET symbols. 

Subscripted SET symbols provide the 
programmer with a convenient way to use one 
SET symbol plus a subscript to refer to 
many arithmetic, binary, or character 
values. 

A subscripted SET symbol consists of a 
SET symbol immediately followed by a 
subscript that is enclosed in parentheses. 
The subscript may be any arithmetic 
expression that is allowed in the operand 
of a SETA statement in the range of 1 to 
the specified dimension. 

Only five levels of parentheses are 
permitted in a SETA or SETE operand. 

The following are valid subscripted SET 
symbols. 

SREADER (17) 
SA23456 (6S4) 
S4F2 (25 + SA2) 

The following are invalid subscripted 
SET symbols. 



SX4F2 
(25) 
SX4F2 (25) 



(no subscript) 
(no SET symbol) 
(subscript does not 
immediately follow 
SET symbol) 



Defining Sub scripted SET Symbols. If the 
programmer wants to use a subscripted SET 
symbcl, he must write in a GBLA, GBLB, 
GBLC, LCLA, LCLE, or LCLC instruction, a 
SET symbol immediately followed by an 
unsigned decimal integer enclosed in 
parentheses. The decimal integer, called a 
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dimension, indicates the number cf SET 
variables associated with the SET syrrbol. 
Every variable associated with a SET symbol 
is assigned an initial value that is the 
same as the initial value assigned to the 
corresponding type of nonsubscripted SE1 
symbol. 

If a subscripted SET symbol is defined 
as global, the same dimension must be used 
with the SET symbol each time it is defined 
as global . 

The maximum dimension that can be used 
with a SETA, SETE, or SETC symbol is 2 55. 



A subscripted SET symbol may be used 
only if the declaration was subscripted. A 
ncnsubscripted SET symbol may be used only 
if the declaration had no subscript. 

The following statements define the 
global SET symbols SSEOX, SWEOX, and SPSW, 
and the local SET symbol STSW. SSEOX has 
50 arithmetic variables associated with it, 
SWEOX has 20 character variables, SPSW and 
STSW each have 230 binary variables. 



I Name 



f- 



- T 1 

| Operation! Operand 
.+ f 

JGBLA J SSBOX (50) 
JGBLC | SWBOX (20) 
JGBLB J SPSW (230) 
JLCLB | STSW (230) 
-J. J 



Using Sub scripted SET Symbols . After the 
programmer has associated a number of SET 
variables with a SET symbol, he may assign 
values to each of the variables and use 
them in other statements. 

If the statements in the previous 
example were part of a macro definition, 
(and SA was defined as a SETA symbol in the 
same definition) , the following statements 
could be part of the same macro definition. 



I Name 



j. 

1 | SA | SETA 

2 | SPSW(SA) JSETB 

3 j STSW (9) | SETE 

4 | | A 
5| |CLI 

l JL 



"I 1 

J Ope rati on | Operand 



|5 

j (6 LT 2) 
| (SPSW(SA)) 
|2,=F' SSBOX (45) ' 
j AREA, C» SWBOX (17) ■ 
.i. 



Statement 1 assigns the arithmetic value 
5 to the nonsubscripted SETA symbol SA. 
Statements 2 and 3 then assign the binary 
value to subscripted SETB symbols SPSW (5) 
and STSW (9), respectively. Statements 4 
and 5 generate statements that add the 
value assigned to SSEOX (45) to general 
register 2, and compare the value assigned 



tc SWEOX (17) to the value stored at AREA, 
respectively. 



System Variable Symbols 



System variable symbols are local variable 
symbols that are assigned values 
automatically £y the assembler. There are 
fcur system variable symbols: SSYSNCX, 
SSYSECT, SSYSLIST, and SSYSPARM. System 
variable symbols may be used in the name, 
operation and operand entries of statements 
in macro definitions, but not in statements 
outside macro definitions with the 
exception of SSYSFARK. They may not be 
defined as symbolic parameters cr SET 
symbols, nor may they be assigned values by 
SETA, SETB, and SETC instructions. 



SSYSNEX — MACRO INSTRUCTION INDEX 



The system variable symbol SSYSNEX may be 
combined with other characters to create 
unique names for statements generated from 
the same model statement. 

SSYSNDX is assigned the four-digit 
number 0001 for the first macro instruction 
processed by the assembler, and it is 
incremented by one for each subsequent 
inner and outer macro instruction 
processed. 

If SSYSNEX is used in a model statement, 
SE1C or MNCTE instruction, or a character 
relation in a SETE or AIF instruction, the 
value substituted for SSYSNEX is the 
four-digit number of the macro instruction 
being processed, including leading zeros. 

If SSYSKDX appears in arithmetic 
expressions (e.g. , in the operand of a SETA 
instruction) , the value used for SSYSNEX is 
an arithmetic value. 

Throughout one u se of a macro 
definition, the v alue of SSYSNDX may be 
considered a constant, independent of any 
inner macro instr uction in that de finition . 

The example in the next column 
illustrates these rules. It is assumed 
that the first macro instruction processed, 
0U1ER1, is the 106th macro instruction 
processed by the assembler. 

Statement 7 is the 106th macro 
instruction processed. Therefore, SSYSNEX 
is assigned the number 0106 for that macro 
instruction. The number 0106 is 
substituted for SSYSNEX when it is used in 
statements 4 and 6. Statement 4 is used to 



11 
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assign the character value 0106 to the SETC 
symbol 6NEXNUM. Statement 6 is used to 
create the unique name E0106. 






I Name 



■1 T 

| Operation | Operand 



[ 


I- 


h 




| MACRO 






| INNER 1 






GBLC 


| SNDXNUM 


1 JASSYSNDX 


| SR 


1 2,5 




CR 


i 2,5 


2| 


| BE 


|B SNDXNUM 


3| 


B 
MEND 

MACRO 


ASSYSNDX 


| SNAME 


OUTER 1 






GBLC 


SNDXNUM 


4 | SNDXNUM 


SETC 


* SSYSNDX' 


| SNAME 


SR 


2,4 




AR 


2,6 


5| 


INNER 1 




6 JBSSYSNDX 

L_ _ J 


S 
MEND 

I _,, j 


2,=FM000' 

1 _ _ 


r 1 






7 j ALPHA 


OUTER 1 




8 j BETA 

L_ J 


OUTER 1 

I j 


1 


r 1 


I 1 


1 — _ 


| ALPHA 


SR 


2,4 




AR 


2,6 


|A0107 


SR 


2,5 




CR 


2,5 




BE 


B0106 




B 


A0107 


|B0106 


S 


2,=F' 1000' 


| BETA 


SR 


2,4 




AR 


2,6 


|A0109 


SR 


2,5 




CR 


2,5 




BE | 


B0108 




B I 


A0109 


|B0108 


s 


2,=F i 1000' 



o 



Statement 5 is the 107th macro 
instruction processed. Therefore, SSYSNDX 
is assigned the number 0107 for that macro 
instruction. The number 0107 is 
substituted for SSYSNEX when it is used in 
statements 1 and 3. The number 0106 is 
substituted for the global SETC symbol 
SNEXNUM in statement 2. 

Statement 8 is the 108th macro 
instruction processed. There fore, each 
occurrence of SSYSNEX is replaced by the 
number 0108. For example, statement 6 is 
used to create the unique name E0108. 

When statement 5 is used to process the 
108th macro instruction, statement 5 
becomes the 109th macro instruction 
processed. Therefore, each occurrence of 
SSYSNDX is replaced by the number 0109. 
For example, statement 1 is used to create 
the unique name A0109. 



SSYSECT— CUPRENT CCNTPCL SECTION 



Ihe system variable symbol SSYSECT may be 
used to represent the name of the control 
section in which a macro instruction 
appears. For each inner and outer macro 
instruction processed by the assembler, 
SSYSECT is assigned a value that is the 
name of the control section in which the 
macro instruction appears. 



Vihen SSYSECT is used in a macro 
definition, the value substituted for 
SSYSECT is the name of the last CSECT, 
DSECT, or START statement that occurs 
before the macro instruction. If no named 
CSECT, DSECT, or START statements occur 
before a macro instruction, SSYSECT is 
assigned a null character value for that 
macro instruction. 



CSECT or DSECT statements processed in a 
macro definition affect the value of 
SSYSECT for any subsequent inner macro 
instructions in that definition, and for 
any other outer and inner macro 
instructions. 



Throughout the use of a macro 
definition, the value of SSYSECT may be 
considered a constant, independent of any 
CSECT or DSECT statements or inner macro 
instructions in that definition. SSYSECT 
will take on the name of the last CSECT, 
DSECT, or START statement regardless of 
whether or not that statement is correct. 

The next example illustrates these 
rules. 

Statement 8 is the last CSECT, ESECT, or 
START statement processed before statement 
9 is processed. Therefore, SSYSECT is 
assigned the value MAINFRCG for macro 
instruction OUTER 1 in statement 9. 
MAINPROG is substituted for SSYSECT when it 
appears in statement 6. 

Statement 3 is the last CSECT, ESECT, or 
START statement processed before statement 
4 is processed. Therefore, SSYSECT is 
assigned the value CSCUT1 for macro 
instruction INNER in statement 4. CS0UT1 
is substituted for SSYSECT when it appears 
in statement 2. 

Statement 1 is used to generate a CSECT 
statement for statement 4. This is the 
last CSECT, DSECT, or START statement that 
appears before statement 5. Therefore, 
SSYSECT is assigned the value INA for macro 
instruction INNER in statement 5. INA is 
substituted for SSYSECT when it appears in 
statement 2. 
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JName 



T T 

| Operation | Operand 



(. 


-f 


MACRO 


h 






INNER 


| SINCSECT 


1 j SINCSECT 




CSECT 




2| 




DC 

MEND 

MACRO 
OUTER 1 


| A (SSYSECT) 


3JCSOUT1 




CSECT 








DS 


| 100C 


*H 




INNER 


INA 


5| 




INNER 


INB 


6| 




DC 

MEND 

MACRO 
OUTER2 


| A (SSYSECT) 


7| 




EC 

MEND 


| A (SSYSECT) 


L _ 










I 






8JMAINPROG 




CSECT 








DS 


|200C 


9| 




OUTER 1 




10| 




OUTER 2 




L 


1 




1 


r — 


1 




1 


JMAINPROG 




CSECT 








DS 


I200C 


|CSOUT1 




CSECT 








DS 


100C 


|INA 




CSECT 








DC 


| A (CSOUT1) 


JINB 




CSECT 








DC 


A (INA) 






DC 


I A (MAINPROG) 






DC 


A (INB) 



l L J. J 

Statement 1 is used to generate a CSECT 
statement for statement 5. This is the 
last CSECT, DSECT, or START statement that 
appears before statement 10. Therefore, 
SSYSECT is assigned the value INB for macro 
instruction OUTER2 in statement 10= INB is 
substituted for SSYSECT when it appears in 
statement 7. 



SSYSLIST — ACCESSING POSITIONAL OPERANDS IN 
A MACRO INSTRUCTION 



The system variable symbol SSYSLIST 
provides the programmer with an alternative 
to symbolic parameters for referring to 
positional macro instruction operands. 

SSYSLIST may be coded, along with all 
other variable symbols (including symbolic 
parameters) , in the model statements of any 
macro definition. (In the Tape Operating 
System (TOS) , SSYSLIST cannot be used in 
macro definitions having any keyword 
symbolic parameters) . When used to access 
a macro instruction operand, SSYSLIST is 
written with one or two subscripts: 



1. SSYSLIST (m) will access the positional 
macro instruction operand 
corresponding to the positional 
operand subscript m. The programmer, 
therefore, does not have to define a 
positional parameter in the macro 
definition prototype statement. This 
allows him to access a different 
number of positional macro instruction 
operands in different calls to the 
same macro. The positional operand 
subscript m can be a self-defining 
term or an absolute expression, but 
its value must be a positive, whole 
number within the range of the number 
of operands permitted in a macro 
instruction. 

Note : A null string will be generated in 
place of SSYSLIST (m) if: 

a. m=0 

b. m is greater than the number of 
positional operands in the macro 
instruction. 

c. m accesses a specifically omitted 
operand . 

The model statement containing 
SSYSLIST (m) will be flagged in error 
if: 

a. m is negative. 

b. m is greater than 100 (for the E 
Assembler) . 

m is greater than 200 (for the F 
Assembler) . 

2. SSYSLIST (m,n) accesses elements of 
positional operand sublists in macro 
instructions. The positional operand 
subscript m fulfills the same function 
as above, and is subjected to the same 
restrictions. The positional operand 
sublist subscript n refers to the 
sublist element of the positional 
operand in a macro instruction 
corresponding to m. Again positional 
parameters need not have been 
previously defined in the macro 
definition prototype statement. 

Note: A null string will be generated in 
place of SSYSLIST (m,n) , m > and otherwise 
within its allowable range, if: 

a. n=0 

b. n is greater than the number of 
elements in the positional operand 
sublist in the macro instruction. 

c. n accesses a specifically omitted 
operand sublist element. 
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The type, length, scaling, integer, and 
count attributes of 6SYSLISTS (m) and 
SSYSLIST (m,n) and the number attributes of 
SSYSLIST (m) and SSYSLIST may be used in 
conditional assembly instructions. 
Attributes are discussed in Section 9 under 
"Attributes. ■ 



N* SSYSLIST refers to the total number of 
positional operands in the macro 
instruction statement. When none have been 
called, N' SSYSLIST has the value 0. If, 
however, some positional operands in the 
macro instruction are specifically emitted 

(by means of commas) , N 'SSYSLIST will 
include the omitted operands in its count 

(see MAC2 and MAC3 in the examples below) . 
A sublist is considered to be one operand 

(see MAC3 below) : 



j Macro Instructions 



JKTSSYSLISTJ 




JMAC1: 

| K1=DS 

1 

JMAC2: 

| ,,K1=DC 

I 

JMAC3: 

| FULL,,F, ( , 1 , , , 2 , , , 3 I ) ,KL=BC 



N' SSYSLIST (m) refers to the total number 
of elements in the macro instruction 
operand sublist corresponding to the 
positional operand subscript m. If the mth 
operand is omitted, N'SSYSLIST (n) is 0; if 
the mth operand is not a sublist, 
N* SSYSLIST (m) is 1. 

In the MAC3 macro instruction above: 

N ( SSYSLIST (4) is 3 

N 1 SSYSLIST (5) is 

N* SSYSLIST (2) is 

N' SSYSLIST (1) is 1 



The system parameter behaves like a 
global SETC symbol except that its value 
can be set only through the OPTION job 
control statement. It cannot be modified 
during assembly. SSYSPARM can be coded 
inside as well as outside macro 
definitions. 6SYSPARM can be used only if 
SPARM=YES was specified in the STDJC macro 
when the system was generated. 

A value to the system parameter is 
assigned with a keyword parameter in the 
OPTION job control card: 



// 



OPTION 



,SYSPARM=* string* ,. . . 



The system parameter will get the value of 
the string within the quotes, which must be 
a character string, 0-8 bytes long. It 
may consist of any combination of EBCDIC 
characters. A single quote in the string 
must be represented by two on the OPTION 
card. If no SSYSPARM value is specified, 
the value of the system parameter will be a 
null string. 



Keyword Macro Definitions and Instructions 

Keyword macro definitions provide the 
programmer with an alternate way of 
preparing macro definitions. 

A keyword macro definition enables a 
programmer to reduce the number of operands 
in each macro instruction that corresponds 
to the definition, and to write the 
operands in any order. 

The macro instructions that correspond 
to the macro definitions described in 
Section 7 (hereinafter called positional 
macro instructions and positional macro 
definitions, respectively) require the 
operands to be written in the same order as 
the corresponding symbolic parameters in 
the operand entry of the prototype 
statement. 



SSYSPARM - System Parameter for Conditional 
Assembly 



(EOS Assembler D, 1<4K variant, only) 

The system parameter SSYSPARM allows the 
programmer to control conditional assembly 
flew and source code generation through the 
use of a parameter specified in a job 
control statement. Thus, the programmer 
can modify the output of an assembly 
without changing the source code itself. 
This can be convenient if an installation 
keeps sections of source code on tape or in 
a source statement library (SYSSLB) . 



In a keyword macro definition, the 
programmer can assign values to any 
symbolic parameters that appear in the 
operand of the prototype statement. The 
value assigned to a symbolic parameter is 
substituted for the symbolic parameter, if 
the programmer does not write anything in 
the operand of the macro instruction to 
correspond to the symbolic parameter. 

When a keyword macro instruction is 
written, the programmer need only write one 
operand for each symbolic parameter whose 
value he wants to change. 

Keyword macro definitions are prepared 
the same way as positional macro 
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definitions, except that the prototype 
statement is written differently, and 
SSYSLIST may not be used in the definition. 
The rules for preparing positional macro 
definitions are in Section 7. 



« t t 1 

{Name {Operation JOperand | 

| +— + j, 

|6N (MOVE |gR=2,6A=S,ST=,SF= J 
I J. JL J 



%J 



KEYWORD MACRO INSTRUCTION 



KEYWORD PROTOTYPE 



The typical form of this statement is: 



[Name 

j. 

| A symbolic 
j parameter 
| or not used 
I 
I 



j Operation! Operand 

f f 

A symbol jOne to 10 (200 
j for F assembler) 
j operands of the 
{form described 
j be low , se par ated 
j by commas . 

JL 



Each operand must consist of a symbolic 
parameter, immediately followed by an equal 
sign and optionally followed by a value. 
Nested keywords are not permitted. 

A value that is part of an operand must 
immediately follow the equal sign . 

Anything that may be used as an operand 
in a macro instruction except variable 
symbols, may be used as a value in a 
keyword prototype statement. The rules for 
forming valid macro instruction operands 
are detailed in Section 8 . 

The following are valid keyword 
prototype operands. 

SREADER= 

6LOOP2=SYMBOL 

gS4==F , 4096* 

The following are invalid keyword 
prototype operands. 



CARDAREA 
STYPE 
6TWO =123 



£AREA= XM89A' 



(no symbolic parameter) 
(no equal sign) 
(equal sign does not 
immediately follow 
symbolic parameter) 
(value does not 
immediately follow equal 
sign) 



The following keyword prototype 
statement contains a symbolic parameter in 
the name entry and four operand entries in 
the operand. Tho first two operand entries 
contain values. The mnemonic operation 
code is MOVE. 



After a programmer has prepared a keyword 
macro definition he may use it by writing a 
keyword macro instruction. 

The typical form of a keyword macro 
instruction is; 



"T T 

| Operation | Operand 



H 



r 

{Name 

h + + 

|A symbol, (Mnemonic |Zero to 100 operands 
(sequence j operation! (200 for F Assembler) 
j symbol jcode jof the form described 
| or not j | below, separated by 
| used | | commas 
i jl x J 

Each operand consists of a keyword 
immediately followed by an equal sign and 
an optional value. Nested keywords are not 
permitted. Anything that may be used as an 
operand in a positional macro instruction 
may be used as a value in a keyword macro 
instruction. The rules for forming valid 
positional macro instruction operands are 
detailed in Section 8. 

A keyword consists of one through seven 
letters and digits, the first of which must 
be a letter. 

The keyword part of each keyword macro 
instruction operand must correspond to one 
of the symbolic parameters that appears in 
the operand of the keyword prototype 
statement. A keyword corresponds to a 
symbolic parameter if the characters of the 
keyword are identical to the characters of 
the symbolic parameter that follow the 
ampersand. 

The following are valid keyword macro 
instruction operands. 

LOOP2=SYMBOL 

S4==F , 4096* 

TO= 

The following are invalid keyword macro 
instruction operands. 



6X4F2=0 (2,3) 
CARDAREA=A+2 
= (TO (8) , (FROM) ) 



(keyword does not begin 
with a letter) 

(keyword is more than 
seven characters) 

(no keyword) 
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The operands in a keyword macro 
instruction may be written in any order. 
If an operand appeared in a keyword 
prototype statement, a corresponding 
operand does not have to appear in the 
keyword macro instruction. If an operand 
is omitted, the comma that would have 
separated it from the next operand need not 
be written. 

The following rules are used to replace 
the symbolic parameters in the statements 
of a keyword macro definition. 

1. If a symbolic parameter appears in the 
name entry of the prototype statement, 
and the name entry of the macro 
instruction contains a symbol, the 
symbolic parameter is replaced by the 
symbol. If the name entry of the 
macro instruction is unused or 
contains a sequence symbol, the 
symbolic parameter is replaced by a 
null character value. 

2. If a symbolic parameter appears in the 
operand of the prototype statement, 
and the macro instruction contains a 
keyword that corresponds to the 
symbolic parameter, the value assigned 
to the keyword replaces the symbolic 
parameter . 

3. If a symbolic parameter was assigned a 
value by a prototype statement, and 
the macro instruction does not contain 
a keyword that corresponds to the 
symbolic parameter, the standard value 
assigned to the symbolic parameter 
replaces the symbolic parameter. 
Otherwise, the symbolic parameter is 
replaced by a null character value. 



Note ; If a symbolic parameter value is a 
self-defining term the type attribute 
assigned to the value is the letter N. If 
a symbolic parameter value is omitted the 
type attribute assigned to the value is 
theletter 0. All other values are assigned 
the type attribute U. 

The following keyword macro definition, 
keyword macro instruction, and generated 
statements illustrate these rules. 

Statement 1 assigns the values 2 and S 
to the symbolic parameters SR and SA, 
respectively. Statement 6 assigns the 
values FA, FB, and THERE to the keywords T, 
F, and A, respectively. The symbol HERE is 
used in the name entry of statement 6. 

Since a symbolic parameter (SN) appears 
in the name entry of the prototype 
statement (statement 1) , and the 
corresponding characters (HERE) of the 
macro instruction (statement 6) are a 



symbol, SN is replaced by HERE in statement 
2. 



r 

(Name 

L _ _ 


T ~ T -=-.=- - - 

| Operation | Operand 
_i , _ j. 


- 1 

1 
J 


I 


| MACRO 


T 
I 


1 


1|SN 


| MOVE 


|SR=2,SA=S,6T=,SF= 




2|SN 


| ST 


|SR,SA 




3| 


I* 


|SR,SF 




"I 


| ST 


|SR,6T 




5j 


|L 


|SR,SA 




I 

6 | HERE 

L 


| MEND 
| MOVE 

L _ 


I 

| T=FA , F=FB , A=THERE 


"I 

— 4 


r 

| HERE 


| ST 


| 2, THERE 


I 


|L 


|2,FB 




I 


| ST 


I 2, FA 




I 


|L 


| 2, THERE 




L 


x _ _ 


A- 


- _j 



Since ST appears in the operand of 
statement 1 , and statement 6 contains the 
keyword (T) that corresponds to ST, the 
value assigned to T (FA) replaces ST in 
statement 4. Similarly, FB and THERE 
replace SF and 6 A in statement 3 and in 
statements 2 and 5, respectively. Note 
that the value assigned to SA in statement 
6 is used instead of the value assigned to 
SA in statement 1 . 

Since SR appears in the operand of 
statement 1 , and statement 6 does not 
contain a corresponding keyword, the value 
assigned to SR (2) , replaces SR in 
statements 2, 3, 4, and 5. 



Operand Sublists . The value assigned to a 
keyword and the value assigned to a 
symbolic parameter may be an operand 
sublist. Anything that may be used as an 
operand sublist in a positional macro 
instruction may be used as a value in a 
keyword macro instruction and as a value in 
a keyword prototype statement. The rules 
for forming valid operand sublists are 
detailed in Section 8 under "Operand 
Sublists . " 

Keyword Inner Macro Instructions . Keyword 
and positional inner macro instructions may 
be used as model statements in either 
keyword or positional macro definitions. 



Mixed- Mode Macro Definitions and 
Instructions 

Mixed-mode macro definitions allow the 
programmer to use the features of keyword 
and positional macro definitions in the 
same macro definition. 
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Mixed-mode macro definitions are 
prepared the same way as positional macro 
definitions, except that the prototype 
statement is written differently. (In TOS 
SYSLIST may not be used in the definition.) 
The rules for preparing positional macro 
definitions are in Section 7. 



The operand consists of two parts. The 
first part corresponds to the positional 
prototype operands. This part of the 
operand is written in the same way that the 
operand entry of a positional macro 
instruction is written. The rules for 
writing positional macro instructions are 
in Section 8. 



MIXED-MODE PROTOTYPE 



The typical form of this statement is: 



r ~ T T 

I Name | Operation | Operand 



| A symbolic 
| parameter 
| or not used 






A symbol |Two to 100 (200 
(for F assembler) 
(operands of the 
j form described 
| below, separated 
| by commas 

x 



The second part of the operand 
corresponds to the keyword prototype 
operands. This part of the operand is 
written in the same way that the operand 
entry of a keyword macro instruction is 
written. The rules for writing keyword 
macro instructions are described under 
"Keyword Macro Instruction." 



The following mixed-mode macro 
definition, mixed -mode macro instruction, 
and generated statements illustrate these 
facilities. 



The operands must be valid operands of 
positional and keyword prototype 
statements. All the positional operands 
must precede the first keyword operand. 
The rules for forming positional operands 
are discussed in Section 7 under "Macro 
Instruction Prototype." The rules for 
forming keyword operands are discussed 
under "Keyword Prototype." 

The following sample mixed-mode 
prototype statement contains three 
positional operands and two keyword 
operands. 

r T T _. ^ 

| Name J Operation | Operand | 

j. _ + _ x .( 

|SN | MOVE j STY, SP, SR,STO=, SF= J 

l X X J 



MIXED-MODE MACRO INSTRUCTION 



The typical form of a mixed-mode macro 
instruction is: 



j Name j Operation j Operand | 

j. x x -I 

{A symbol, | Mnemonic | Zero to 100 operands 
| sequence | operation! (200 for F Assembler) 
| symbol jcode |of the form described 
| or not J | below, separated by 
j used j j commas 
i — , x x 



Name 



. T , T 

| Operation | Operand 



j. 

| | MACRO 

1|SN | MOVE 

|SN JSTSTY 

j |LSTY 

j j STSTY 

| |LSTY 

2 | HERE | MOVE 

|. + 

| HERE j STH 

I |LH 

j | STH 

L_ X 



|STY,SP,SR,STO=,SF= 

|6R,SAVE 

|6R,SP6F 

|SR,SPSTO 

|SR,SAVE 

|H,,2,F=FB,TO=FA 



j 2, SAVE 
|2,FB 
| 2, FA 
| 2, SAVE 
.X 



The prototype statement (statement 1) 
contains three positional operands (STY,SP, 
and SR) and two keyword operands (STO and 
SF) . In the macro instruction (statement 
2) the positional operands are written in 
the same order as the positional operands 
in the prototype statement (the second 
operand is omitted) . The keyword operands 
are written in an order that is different 
from the order of keyword operands in the 
prototype statement. 



Mixed-mode inner macro instructions may 
be used as model statements in mixed-mode, 
keyword, and positional macro definitions. 
Keyword and positional inner macro 
instructions may be used as model 
statements in mixed-mode macro definitions. 



V^ 
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Conditional Assembly Compatibility in an appropriate lcla, lclb, lclc, gel a, 

GBLB, or GBLC statement. The AIFB and AGOB 
instructions are processed by the DOS/TOS 
Macro definitions prepared for use with the assembler the same way that the AIF and AGO 
other IBM System/360 Operating System instructions are processed. AIFB and AGOB 
assemblers having macro language facilities instructions cause the count set up by the 
may be used with the DOS/TOS assembler ACTR instruction to be decremented exactly 
provided that all SET symbols are declared like the AGO and AIF instructions. 



o 



o 
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Appendix A. Extended Binary Coded Decimal 
Interchange Code (EBCDIC) 



The following charts and the associated key 
show the bit configurations of the 256 
possible codes (characters) of the Extended 
BCD Interchange Code. To write a given 
character in binary, locate the character 
on the chart. The top row of coordinates 
equates to bit positions and 1, the 
second row to bit positions 2 and 3, and 
the left row of coordinates equates to bit 
positions 1, 5, 6 and 7. 

Examples; 

Character A equals: 

top row — 11 (bit positions 0, 1) 

2nd row — 00 (bit positions 2, 3) 

left row — 0001 (bit positions 4, 5, 6 
and 7) 

Therefore, character A is shown as: 

1100 0001 

Character $ equals: 

top row — 01 (bit positions 0, 1) 

2nd row — 01 (bit positions 2,. 3) 

left row — 1011 (bit positions H, 5, 6 
and 7) 



Therefore, character $ is shown as: 



0101 1011 



The coordinates on the bottom of the 
chart are the three zone punches required 
to reproduce the character in a punched 
card; the coordinates on the right side 
represent the numeric punches. 



Examples : 



Character A = bottom row-- 12 punch 
right row — 1 punch 

Therefore, character A is shown by a 12 
and a 1 punch in the same card column. 

Character $ = bottom row-- 11 punch 

right row — 8 and 3 punches 

Therefore, character $ is shown by 11, 
8, and 3 punches in the same card column. 

There are fifteen exceptions to the 
punching equated to bit positions. These 
exceptions are shown in the chart by 
circled numbers 1 through 15, and the 
substituted punching is shown below the 
chart under "Exceptions." 
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Bit Positions 
0, 1 



»f »/ ■.*» , t? , [tt|9r : io yp!LE2!«2 



Positions 
3 



.. <**»-;' 



<X»0 



oon 



*1W 



^?^ 



Mil 



wa 



HO© 



j*W:.i 



,»H. 



TD 


(2) 


£ 


© 


S^ 


& ^ 


© 


(§3 








SOS 








/( ji 








FS 




























PF 


RES 


BYP 


PN 










HT 


NL 


LF 


RS 










LC 


BS 


EOB 


UC 










DEL 


IL 


CRE 


EOT 


















niiiiikb 


I 
1 


■ 


■ 
111 


1 

gggfl 


■ 

[a. 


♦i^- 


■ 
I 

H 
m 




H 2 


oneP 


unche 







J! -o 

8 «»: 



M 





v.\«& *':. 






.'.:*»•:•':'•. 




Bit Positions 






* 6, 1 


;• 


« 


16 


B 


;*>. 


« 


»© 


tt 


Bit Positions 


2,3 



\m.Ai 



















H 






SM 




* 


! 


d 




1 












$ 


r 


# 


IH 










< 


¥ 


% 


@ 


11 










( 


) 


_ 


i 


■ 










+ 




> 


= 


1 










i 


— , 


? 


• 


■ 


— ■■ 






one Punche 






r 










■i 








[ 






ill; 


Bit Positions 


,w It " 


' 0, 1 


00 0* 


»|*t||o» 


91 1 10 


■ ■ 


Bit Positions 


2,3 



0800 










~©"^ 


0^ 


Ih 


0001 





I 






A 


J 


(Uj 




um 


m§ 


b 


k 


s 




B 


K 


S 


2 


H 


SOU 


c 


1 


t 




C 


L 


T 


3 


",,'fp 


. ®w t 


d 


m 


u 




D 


M 


U 


4 


La 


$P 


e 


n 


V 




E 


N 


V 


5 


N 


ana 


f 





w 




F 


O 


W 


6 


H 


mi i 


9 


P 


X 




G 


P 


X 


7 


Lj£ 


»*» 1 


h 


q 


y 




H 


O 


Y 


8 


|*'2 


HHK , 


i 


r 


X 




I 


R 


Z 


9 


H 




h 


Zone Punches » 




ie - 


' n 


Bit Positions 


' 0, I 


00 


in 


10 

pip 


1* 


00 


0} 


»ft 


H 


Bit Positions 


2,3 





T ltti ' 


















n 


mi 


















•V- 


woo 


















1 


HO* 


















B 


tm 


















ill 


?m 












1 












•Jilil 


11111111 








'one Punche 






I* 










■ 





© 


12-0-9-8-1 


© 


No Punches 


© 


12-0 


© 


12-11-9-8-1 


© 


12 


© 


11-0 


© 


11-0-9-8-1 


© 


11 


© 


0-8-2 


© 


12-11-0-9-8-1 


© 


12-11-0 


© 






(13) 0-1 
© 11-0-9-1 
(g) 12-11 



© 



Figure 15. Extended Binary Coded Decimal Interchange Code (Part 1 of 2) 
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Control Characters 










PF Punch Off 


BS 


Backspace 


FN 


Funch On 


HT Horizontal Tab 


IL 


Idle 


RS 


Peader Stop 


LC Lower Case 


BY 


Bypass 


UC 


Upper Case 


DL Delete 


LF 


Line Feed 


ET 


End of Transmission 


RE Restore 


EB 


End of Block 


sm 


Set Mode 


NL New Line 


PR 


Prefix 


SP 


Space 


DS Digit Select 


SOS 


Start of Significance 


FS 


Field Separator 



Special Graphic Characters 

Cent Sign * 

Period, Decimal Point ) 

Less- than Sign ; 

Left Parenthesis -• 
Plus Sign 

Vertical Bar, Logical OR / 

Ampersand , 

Exclamation Point % 

Dollar Sign _ 



Asterisk 


> 


Greater- than Sign 


Right Parenthesis 


? 


Question Mark 


Semicolon 


: 


Colon 


Logical N01 


* 


Number Sign 


Minus Sign, Hyphen 


a 


At Sign 


Slash 


• 


Frime, Apostrophe 


Comma 


= 


Equal Sign 


Percent 


H 


Quotation Mark 


Underscore 







Examples j 
I 



Type 



T T 

Bit Pattern 
Bit Positions J- 
01 23 4567 



PF 



j Control Character 



j Special Graphic 



| Upper Case 



j Lower Case 



j Control Character, 
j function not yet 
j assigned 



00 00 0100 



01 10 1100 



11 01 1001 



10 00 0001 



00 11 0000 



Hole Fattern 

T' 



Zone Punches 



| Digit Punches 



12-9-4 
J0-8-4 



11-9 



H 



12-0-1 



12-11-0-9-8-1 
I 
I 



Figure 15. Extended Binary Coded Decimal Interchange Code (Fart 2 of 2) 
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Appendix B. Hexadecimal -Decimal Number Conversion Table 



The table in this appendix provides for 
direct conversion of decimal and 
hexadecimal numbers in these ranges: 

r 1 1 

| Hexadecimal | Decimal | 
j. f , 

J000 to FFF j 0000 to 4095 | 

l i. ., j 



For example, the decimal number 123 has 
the hexadecimal equivalent of 07B; the 
decimal number 1478 has the hexadecimal 
equivalent of 5C6 . 



For numbers outside the range of the 
table, add the following values to the 
table 



O 



Decimal numbers (0000- 4095) are given 
within the 5- part table. The first two 
characters (high-order) of hexadecimal 
numbers (000-FFF) are given in the lefthand 
column of the table; the third character 
(x) is arranged across the top of each part 
of the table. 

To find the decimal equivalent of the 
hexadecimal number 0C9, look for 0C in the 
left column, and across that row under the 
column for x = 9. The decimal number is 
0201. 

To convert from decimal to hexadecimal, 
look up the decimal number within the table 
and read the hexadecimal number by a 
combination of the hex characters in the 
left column, and the value for x at the top 
of the column containing the decimal 
number . 



I— T — 




| Hexadecimal 


[Decimal 


I 


| + 


H 


| 1000 


4096 




| 2000 


| 8192 




| 3000 


| 12288 




| 4000 


| 16384 




| 5000 


| 20480 




| 6000 


| 24576 




| 7000 


| 28672 




| 8000 


| 32768 




| 9000 


| 36864 




J A000 


40960 




| B000 


| 45056 




| COOO 


| 49152 




| D000 


53248 




| E000 


| 57344 




[ F000 


I 61440 
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x ■ 


1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


P 


OOx 
01x 
02x 
03x 


0000 
0016 
0032 
0048 


0001 
0017 
0033 
0049 


0002 
0018 
0034 
0050 


0003 
0019 
0035 
0051 


0004 
0020 
0036 
0052 


0005 
0021 
0037 
0053 


0006 
0022 
0038 
0054 


0007 
0023 
0039 
0055 


0008 
0024 
0040 
0056 


0009 
0025 
0041 
0057 


0010 
0026 
0042 
0058 


0011 
0027 
0043 
0059 


0012 
0028 
0044 
0060 


0013 
0029 
0045 
0061 


0014 
0030 
0046 
0062 


0015 
0031 
0047 
0063 


04x 
05x 
06x 
07x 


0064 
0080 
0096 
0112 


0065 
0081 
0097 
0113 


0066 
0082 
0098 
0114 


0067 
0083 
0099 
0115 


0068 
0084 
0100 
0116 


0069 
0085 
0101 
0117 


0070 
0086 
0102 
0118 


0071 
0087 
0103 
0119 


0072 
0088 
0104 
0120 


0073 
0089 
0105 
0121 


0074 
0090 
0106 
0122 


0075 
0091 
0107 
0123 


0076 
0092 
0108 
0124 


0077 
0093 
0109 
0125 


0078 
0094 
0110 
0126 


0079 
0095 
0111 
0127 


08x 
09x 
OAx 
OBx 


0128 
0144 
0160 
0176 


0129 
0145 
0161 
0177 


0130 
0146 
0162 
0178 


0131 
0147 
0163 
0179 


0132 
0148 
0164 
0180 


0133 
0149 
0165 
0181 


0134 
0150 
0166 
0182 


0135 
0151 
0167 
0183 


0136 
0152 
0168 
0184 


0137 
0153 
0169 
0185 


0138 
0154 
0170 
0186 


0139 
0155 
0171 
0187 


0140 
0156 
0172 
0188 


0141 
0157 
0173 
0189 


0142 
0158 
0174 
0190 


0143 
0159 
0175 
0191 


OCx 
OOx 
OEx 
OPx 


0192 
0208 
0224 
0240 


0193 
0209 
0225 
0241 


0194 
0210 
0226 
0242 


0195 
0211 
0227 
0243 


0196 
0212 
0228 
0244 


0197 
0213 
0229 
0245 


0198 
0214 
0230 
0246 


0199 
0215 
0231 
0247 


0200 
0216 
0232 
0248 


0201 
0217 
0233 
0249 


0202 
0218 
0234 
0250 


0203 
0219 
0235 
0251 


0204 
0220 
0236 
0252 


0205 
0221 
0237 
0253 


0206 
0222 
0238 
0254 


0207 
0223 
0239 
0255 


10x 
11x 
12x 
13x 


0256 
0272 
0288 
0304 


0257 
0273 
0289 
0305 


0258 
0274 
0290 
0306 


0259 
0275 
0291 
0307 


0260 
0276 
0292 
0308 


8261 
0277 
0293 
0309 


0262 
0278 
0294 
0310 


0263 
0279 
0295 
0311 


0264 
0280 
0296 
0512 


0265 
0281 
0297 
0313 


0266 
0282 
0298 
0314 


0267 
0283 
0299 
0315 


0268 
0284 
0300 
0316 


0269 
0285 
0301 
0317 


0270 
0286 
0302 
0318 


0271 
0287 
0303 
0319 


14x 
15x 
16x 
17x 


0320 
0336 
03S2 
0368 


0321 
0337 
0353 
0369 


0322 
0338 
0354 
0370 


0323 
0339 
0355 
0371 


0324 
0340 
0356 
0372 


0325 
0341 
0357 
0373 


0326 
0342 
0358 
0374 


0327 
0343 
0359 
0375 


0328 
0344 
0360 
0376 


0329 
0345 
0361 
0377 


0330 
0346 
0362 
0378 


0331 
0347 
0363 
0379 


0332 
0348 
0364 
0380 


0333 
0349 
0365 
0381 


0334 
0350 
0366 
0382 


0335 
0351 
0367 
0383 


18x 
19x 
lAx 
IBx 


0384 
0400 
0416 
0432 


0385 
0401 
0417 
0433 


0386 
0402 
0418 
0434 


0387 
04D3 
041? 
0435 


0388 
0404 
0420 
0436 


0389 
0405 
0421 
0437 


0390 
0406 
0422 
0438 


0391 
0407 
0423 
0439 


0392 
0408 
0424 
0440 


0393 
0409 
0425 
0441 


0394 
0410 
0426 
0442 


0395 
0411 
0427 
0443 


0396 
0412 
0428 
0444 


0397 
0413 
C429 
0445 


0398 
0414 
0430 
0446 


0399 
0415 
0431 
0447 


1Cx 
IDx 
1Ex 
1Fx 


0448 
0464 
0480 
0496 


0449 
0465 
0481 
0497 


0450 
0466 
0482 
0498 


0451 
0467 
0483 
0499 


0452 
0468 
0484 
0500 


0453 
0469 
0485 
0501 


0454 
0470 
0486 
0502 


0455 
0471 
0487 
0503 


0456 
0472 
0488 
0504 


0457 
0473 
0489 
0505 


0458 
0474 
0490 
0506 


0459 
0475 
0491 
0507 


0460 
0476 
0492 
0508 


0461 
0477 
0493 
0509 


0462 
0478 
0494 
0510 


0463 
0479 
0495 
0511 


20x 
21x 
22x 
23x 


0512 
0528 
0544 
0560 


0513 
0529 
0545 
0561 


0514 
0530 
0546 
0562 


0515 
0531 
0547 
0563 


0516 
0532 
0548 
0564 


0517 
0533 
0549 
0565 


0518 
0534 
0550 
0566 


0519 
0535 
0551 
0567 


0520 
0536 
0552 
0568 


0521 
0537 
0553 
0569 


0522 
0538 
0554 
0570 


0523 
0539 
0555 
0571 


0524 
0540 
0556 
0572 


0525 
0541 
0557 
0573 


0526 
0542 
0558 
0574 


0527 
0543 
0559 
0575 


2«x 
25x 
26x 
27x 


0576 
0592 
0608 
0624 


0577 
0593 
0609 
0625 


0578 
0594 
0610 
0626 


0579 
0595 
0611 
0627 


0580 
0596 
0612 
0628 


0581 
0597 
0613 
0629 


0582 
0598 
0614 
0630 


0583 
0599 
0615 
0631 


0584 
0600 
0616 
0632 


0585 
0601 
0617 
0633 


0586 
0602 
0618 
0634 


0587 
0603 
0619 
0635 


0588 
0604 
0620 
0636 


0589 
0605 
0621 
0637 


0590 
0606 
0622 
0638 


0591 
0607 
0623 
0639 


28x 
29x 
2Ax 

2Bx 


0640 
0656 
0672 
0688 


0641 
0657 
0673 
0689 


0642 
0658 
0674 
0690 


0643 
0659 
0675 
0691 


0644 
0660 
0676 
0692 


0645 
0661 
0677 
0693. 


0646 
0662 
0678 
0694 


0647 
0663 
0679 
0695 


0648 
0664 
0680 
0696 


0649 
0665 
0681 
0697 


0650 
0666 
0682 
0698 


0651 
0667 
0683 
0699 


0652 
0668 
0684 
0700 


0653 
0669 
0685 
0701 


0654 
0670 
0686 
0702 


0655 
0671 
0687 
0703 


2Cx 
2Dx 
2Ex 
2Fx 


0704 
0720 
0736 
0752 


0705 
0721 
0737 
0753 


0706 
0722 
0738 
0754 


0707 
0723 
0739 
0755 


0708 
0724 
0740 
0756 


0709 
0725 
0741 
0757 


0710 
0726 
0742 
0758 


0711 
0727 
07113 
0759 


0712 
0728 
0744 
0760 


0713 
0729 
0745 
0761 


0714 
0730 
0746 
0762 


0715 
0731 
0747 
0763 


0716 
0732 
0748 
0764 


0717 
0733 
0749 
0765 


0718 
0734 
0750 
0766 


0719 
0735 
0751 
0767 


30x 
31x 
32x 
33x 


0768 
0784 
0800 
0816 


0769 
0785 
0801 
0817 


0770 
0786 
0802 
08-18 


0771 
0787 
0803 
0819 


0772 
0788 
0804 
0820 


0773 
0789 
0805 
0821 


0774 
0790 
0806 
0822 


0775 
0791 
0807 
0823 


0*76 
0792 
0808 
0824 


0777 
0793 
0809 
0825 


0778 
0794 
0810 
0826 


0779 
0795 
0811 
0827 


0780 
0796 
0812 
0828 


0781 
0797 
0813 
0829 


0782 
0798 
0814 
0830 


0783 
0799 
0815 
0831 


34x 
35x 
36x 
37x 


0832 
0848 
0864 
0880 


0833 
0849 
0865" 
0881 


0834 
0850 
0866 
0882 


0835 
0851 
0867 
0883 


0836 
0852 
0868 
0884 


0837 
0853 
0869 
0885 


0838 
0854 
0870 
0886 


0839 
0855 
0871 
0887 


0840 
0856 
0872 
0888 


0841 
0857 
0873 
0889 


0842 
0858 
0874 
0890 


0843 
0859 
0875 
0891 


0844 
0860 
0876 
0892 


0845 
0861 
0877 
0893 


0846 
0862 
0878 
0894 


0847 
0863 
0879 
0895 


38x 
39x 
3Ax 

3Bx 


0896 
0912 
0928 
0944 


0897 
0913 
0929 
0945 


0898 
0914 
0930 
0946 


0899 
0915 
0931 
0947 


0900 
0916 
0932 
0948 


0901 
0917 
0933 
0949 


0902 
0918 
0934 
0950 


0903 
0919 
0935 
0951 


0904 
0920 
0936 
0952 


0905 
0921 
0937 
0953 


0906 
0922 
0938 
0954 


0907 
0923 
0939 
0955 


0908 
0924 
0940 
0956 


0909 
0925 
0941 
0957 


0910 
0926 
0942 
0958 


0911 
0927 
0943 
0959 


3Cx 
3Dx 
3Ex 
3Fx 


0960 
0976 
0992 
1008 


0961 
0977 
0993 
1009 


0962 
0978 
0994 
1010 


0963 
0979 
0995 
1011 


0964 
0980 
0996 
1012 


0965 
0981 
0997 
1013 


0966 
0982 
0998 
1014 


0967 
0983 
0999 
1015 


0968 
0984 
1000 
1016 


0969 
0985 
1001 
1017 


0970 
0986 
1002 
1018 


0971 
0987 
1003 
1019 


0972 
0988 
1004 
1020 


0973 
09*9 
1005 
1021 


0974 
0990 
1006 
1022 


0975 
0991 
1007 
1023 



{4 Y, 

\4 m 
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x ■ 


1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


40x 
41x 

43x 


1024 
1040 
1056 
1072 


1025 
1041 
1057 
1073 


1026 
1042 
1058 
1074 


1027 
1043 
1059 
1075 


1028 
1044 
1060 
1076 


1029 
1045 
1061 
1077 


1030 
1046 
1062 
1078 


1031 
1047 
1063 
1079 


1032 
1048 
1064 
1080 


1033 
1049 
1065 
1081 


1034 
1050 
1066 
1082 


1035 
1051 
1067 
1083 


1036 
1052 
1068 
1084 


1037 
1053 
1069 


1038 
1054 
1070 
1086 


1039 
1055 
1071 
1087 


44x 
45x 

46x 
47x 


1088 
1104 
1120 
1136 


1089 
1105 
1121 
1137 


1090 
1106 
1122 
1138 


1091 
1107 
1123 
1139 


1092 
1108 
1124 
1140 


1093 
1109 
1125 
1141 


1094 
1110 
1126 
1142 


1095 
1111 
1127 
1143 


1096 
1112 
1128 
1144 


1097 
1113 
1129 
1145 


1098 
1114 
1130 
1146 


1099 
1115 
1131 
1147 


1100 
1116 
1132 
1148 


1101 
1117 
1133 
1149 


1102 
1118 
1134 
1150 


1103 
1119 
1135 
1151 


48x 
49x 
4 Ax 

4Bx 


1152 
1168 
1184 
1200 


1153 
1169 
1185 
1201 


1154 
1170 
1186 
1202 


1155 
1171 
1187 
1203 


1156 
1172 
1188 
1204 


1157 
1173 
1189 
1205 


1158 
1174 
1190 
1206 


1159 
1175 
1191 
1207 


1160 
1176 
1192 
1208 


1161 
1177 
1193 
1209 


1162 
1178 
1194 
1210 


1163 
1179 
1195 
1211 


1164 
1180 
1196 
1212 


1165 
1181 
1197 
1213 


1166 
1182 
1198 
1214 


1167 
1183 
1199 
1215 


4Cx 
4Dx 
4 Ex 
4Fx 


1216 
1232 
1248 
1264 


1217 
1233 
1249 
1265 


1218 
1234 
1250 
1266 


1219 
1235 
1251 
1267 


1220 
1236 
1252 
1268 


1221 
1237 
1253 
1269 


1222 
1238 
1254 
1270 


1223 
1239 
1255 
1271 


1224 
1240 
1256 
1272 


1225 
1241 
1257 
1273 


1226 

1242 
1258 
1274 


1227 
1243 
1259 
1275 


1228 
1244 
1260 
1276 


1229 
1245 
1261 
1277 


1230 
1246 
1262 
1278 


1231 
1247 
1263 
1279 


50x 
51x 
52x 
53x 


1280 
1296 
1312 
1328 


1281 
1297 
1313 
1329 


1282 
1298 
1314 
1330 


1283 
1299 
1315 
1331 


1284 
1300 
1316 
1332 


1285 
1301 
1317 
1333 


1286 
1302 
1318 
1334 


1287 
1303 
1319 
1335 


1288 
1304 
1320 
1336 


1289 
1305 
1321 
1337 


1290 
1306 
1322 
1338 


1291 
1307 
1323 
1339 


1292 
1308 
1324 
1340 


1293 
1309 
1325 
1341 


J294 
1310 
1326 
1342 


1295 
1311 
1327 
1343 


54x 
55x 

56x 
S7x 


1344 
1360 
1376 
1392 


1345 
1361 
1377 
1393 


1346 
1362 
1378 
1394 


1347 
1363 
1379 
1395 


1348 
1364 
1380 
1396 


1349 
1365 
1381 
1397 


1350 
1366 
1382 
1398 


1351 
1367 
1383 
1399 


1352 
1368 
1384 
1400 


1353 
1369 
1385 
1401 


1354 
1370 
1386 
1402 


1355 
1371 
1387 
1403 


1356 
1372 
1388 
1404 


1357 
1373 
1389 
1405 


1358 
1374 
1390 
1406 


1359 
1375 
1391 
1407 


58x 
59x 
5Ax 
SBX 


1408 
1424 
1440 
1456 


1409 
1425 
1441 
1457 


1410 
1426 
1442 
1458 


1411 
1427 
1443 
1459 


1412 
1428 
1444 
1460 


1413 
1429 
1445 
1461 


1414 
1430 
1446 
1462 


1415 
1431 
1447 
1463 


1416 
1432 
1448 
1464 


1417 
1433 
1449 
1465 


1418 
1434 
1450 
1466 


1419 
1435 
1451 
1467 


1420 
1436 
1452 
1468 


1421 
1437 
1453 
1469 


1422 
1438 
1454 
1470 


1423 
1439 
1455 
1471 


5Cx 
SDx 
5BX 
SFX 


1472 
1488 
1504 
1520 


1473 
1489 
1505 
1521 


1474 
1490 
1506 
1522 


1475 
1491 
1507 
1523 


1476 
1492 
1508 
1524 


1477 
1493 
1509 
1525 


1478 
1494 
1510 
1526 


1479 
1495 
1511 
1527 


1480 
1496 
1512 
1528 


1481 
1497 
1513 
1529 


1482 
1498 
1514 
1530 


1483 
1499 
1515 
1531 


1484 
1500 
1516 
1532 


1485 
1501 
1517 
1533 


1486 
1502 
1518 
1534 


1487 
1503 
1519 
1535 


60x 
61x 
62x 
63x 


1536 
1552 
1568 
1584 


1537 
1553 
1569 
1585 


1538 
1554 
1570 
1586 


1539 
1555 
1571 
1587 


1540 
1556 
1572 
1588 


1541 
1557 
1573 
1589 


1542 
1558 
1574 
1590 


1543 
1559 
1575 
1591 


1544 
1560 
1576 
1592 


1545 
1561 
1577 
1593 


1546 
1562 
1578 
1594 


1547 
1563 
1579 
1595 


1548 
1564 
1580 
1596 


1549 
1565 
1581 
1597 


1550 
1566 
1582 
1598 


1551 
1567 
1583 
1599 


64x 
65x 
66x 
67x 


1600 
1616 
1632 
1648 


1601 
1617 
1633 
1649 


1602 
1618 
1634 
1650 


1603 
1619 
1635 
1651 


1604 
1620 
1636 
1652 


1605 
1621 
1637 
1653 


1606 
1622 
1638 
1654 


1607 
1623 
1639 
1655 


1608 
1624 
1640 
1656 


1609 
1625 
1641 
1657 


1610 
1626 
1642 
1658 


1611 
1627 
1643 
1659 


1612 
1628 
1644 
1660 


1613 
1629 
1645 
1661 


1614 
1630 
1646 
1662 


1615 
1631 
1647 
1663 


68x 
69x 
6Ax 
6Bx 


1664 
1680 
1696 
1712 


1665 
1681 
1697 
1713 


1666 
1682 
1698 
1714 


1667 
1683 
1699 
1715 


1668 
1684 
1700 
1716 


1669 
1685 
1701 
1717 


1670 
1686 
1702 
1718 


1671 
1687 
1703 
1719 


1672 
1688 
1704 
1720 


1673 
1689 
1705 
1721 


1674 
1690 
1706 
1722 


1675 
1691 
1707 
1723 


1676 
1692 
1708 
1724 


1677 
1693 
1709 
1725 


1678 
1694 
1710 
1726 


1679 
1695 
1711 
1727 


6Cx 
6Dx 
6Ex 
6Fx 


1728 
1744 
1760 
1776 


1729 
1745 
1761 
1777 


1730 
1746 
1762 
1778 


1731 
1747 
1763 
1779 


1732 
1748 
1764 
1780 


1733 
1749 
1765 
1781 


1734 
1750 
1766 
1782 


1735 
1751 
1767 
1783 


1736 
1752 
1768 
1784 


1737 
1753 
1769 
1785 


1738 
1754 
1770 
1786 


1739 
1755 
1771 
1787 


1740 
1756 
1772 
1788 


1741 
1757 
1773 
1789 


1742 
1758 
1774 
1790 


1743 
1759 
1775 
1791 


70x 
71x 
72x 
73x 


1792 
1808 
1824 
1840 


1793 
1809 
1825 
1841 


1794 
1810 
1826 
1842 


1795 
1811 
1827 
1843 


179 6 
1812 
1828 
1844 


1797 
1813 
1829 
1845 


1798 
1814 
1830 
1846 


1799 
1815 
1831 
1847 


1800 
1816 
1832 
1848 


1801 
1817 
1833 
1849 


1802 
1818 
1834 
1850 


1803 
1819 
1835 
1851 


1804 
1820 
1836 
1852 


1805 
1821 
1837 
1853 


1806 
1822 
1838 
1854 


1807 
1823 
1839 
1855 


74x 
7Sx 
76x 
77x 


1856 
1872 
1888 
1904 


1857 
1873 
1889 
1905 


1858 
1874 
1890 
1906 


1859 
1875 
1891 
1907 


1860 
1876 
1892 
1908 


1861 
1877 
1893 
1909 


1862 
1878 
1894 
1910 


1863 
1879 
1895 
1911 


1864 
1880 
1896 
1912 


1865 
1881 
1897 
1913 


1866 
1882 
1898 
1914 


1867 
1883 
1899 
1915 


1868 
1884 
1900 
1916 


1869 
1885 
1901 
1917 


1870 
1886 
1902 
1918 


1871 
1887 
1903 
1919 


78x 
79x 
7 Ax 
7Bx 


1920 
1936 
1952 
1968 


1921 
1937 
1953 
1969 


1922 
1938 
1954 
1970 


1923 
1939 
1955 
1971 


1924 
1940 
1956 
1972 


1925 
1941 
1957 
1973 


1926 
1942 
1958 
1974 


1927 
1943 
1959 
1975 


1928 
1944 
1960 
1976 


1929 
1945 
1961 
1977 


1930 
1946 
1962 
1978 


1931 
1947 
1963 
1979 


1932 
1948 
1964 
1980 


1933 
1949 
1965 
1981 


1934 
1950 
1966 
1982 


1935 
1951 
1967 
1983 


7Cx 
7Dx 
7Ex 
7Fx 


1984 
2000 
2016 
2032 


1985 
2001 
2017 
2033 


1986 
2002 
2018 
2034 


1987 
2003 
2019 
2035 


1988 
2004 
2020 
2036 


1989 
2005 
2021 
2037 


1990 
2006 
2022 
2038 


1991 
2007 
2023 
2039 


1992 
2008 
2024 
2040 


1993 
2009 
2025 
2041 


1994 
2010 
2026 
2042 


1995 
2011 
2027 
2043 


1996 
2012 
2028 
2044 


1997 
2013 
2029 
2045 


1998 
2014 
2030 
2046 


1999 
2015 
2031 
2047 



CI 



Appendix B: Hexadecimal-Decimal Number Conversion Table 117 





x = 


1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


80x 
81x 
82x 
33x 


2048 
2064 
2080 
2096 


2049 
2065 
2081 
2097 


2050 
2066 
2082 
2098 


2051 
2067 
20 83 
2099 


2052 
2068 
2084 
2100 


2053 
2069 
2085 
2101 


2054 
2070 
2086 
2102 


2055 
2071 
2087 
2103 


2056 
2072 
2088 
2104 


2057 
2073 
2089 
2105 


2058 
2074 
2090 
2106 


2059 
2075 
2091 
2107 


2060 
2076 
2092 
2108 


2061 
2077 
2093 
2109 


2062 
2078 
2094 
2110 


2063 
2079 
2095 
2111 


84x 
85x 
86x 
87x 


2112 
2128 
2144 
2160 


2113 
2129 
2145 
2161 


2114 
2130 
2146 
2162 


2115 
2131 
2147 
2163 


2116 
2132 
2148 
2164 


2117 
2133 
2149 
2165 


2118 
2134 
2150 
2166 


2119 
2135 
2151 
2167 


2120 
2136 
2152 
2168 


2121 
2137 
2153 
2169 


2122 
2138 
2154 
2170 


2123 
2139 
2155 
2171 


2124 
2140 
2156 
2172 


2125 
2141 
2157 
2173 


2126 
2142 
2158 
2174 


2127 
2143 
2159 
2175 


88x 
89x 
8Ax 

8Bx 


2176 
2192 
2208 
2224 


2177 
2193 
2209 
2225 


2178 
2194 
2210 
2226 


2179 
2195 
2211 
2227 


2180 
2196 
2212 
2228 


2181 
2197 
2213 
2229 


2182 
2198 
2214 
2230 


2183 
2199 
2215 
2231 


2184 
2200 
2216 
2232 


2185 
2201 
2217 
2233 


2186 
2202 
2218 
2234 


2187 
2203 
2219 
2235 


2188 
2204 
2220 
2236 


2189 
2205 
2221 
2237 


2190 
2206 
2222 
2238 


2191 
2207 
2223 
2239 


8Cx 
8Dx 
8Ex 
8Fx 


2240 
2256 
2272 
2288 


2241 
2257 
2273 
2289 


2242 
2258 
2274 
2290 


2243 
2259 
2275 
2291 


2244 
2260 
2276 
2292 


2245 
2261 
2277 
2293 


2246 
2262 
2278 
2294 


224 7 
2263 
2279 
229 S 


2248 
2264 
2280 
2296 


2249 
2265 
2281 
2297 


2250 
2266 
2282 
2298 


2251 
2267 
2283 
2299 


2252 
2268 
2284 
2300 


2253 
2269 
2285 
2301 


2254 
2270 
2286 
2302 


2255 
2271 
2287 
2303 


90x 
91x 
92x 
93x 


2304 
2320 
2336 
2352 


2305 
2321 
2337 
2353 


2306 
2322 
2338 
2354 


2307 
2323 
2339 
2355 


2308 
2324 
2340 
2356 


2309 
2325 
2341 
2357 


2310 
2326 
2342 
2358 


2311 
2327 
2343 
2359 


2312 
2328 
2344 
2360 


2313 
2329 
2345 
2361 


2314 
2330 
2346 
2362 


2315 
2331 
2347 
2363 


2316 
2332 
2348 
2364 


2317 
2333 
2349 
2365 


2318 
2334 
2350 
2366 


2319 
2335 
2351 
2367 


94x 
95x 
96x 
97x 


2368 
2384 
2400 
2416 


2369 
2385 
2401 
2417 


2370 
2386 
2402 
2418 


2371 
2387 
24 03 
2419 


2372 
2388 
2404 
2420 


2373 
2389 
2405 
2421 


2374 
2390 
2406 
2422 


2375 
2391 
2407 
2423 


2376 
2392 
2408 
2424 


2377 
2393 
2409 
2425 


2378 
2394 
2410 
2426 


2379 
2395 
2411 
2427 


2380 
2396 
2412 
2428 


2381 
2397 
2413 
2429 


2382 
2398 
2414 
2430 


2383 
2399 
2415 
2431 


98x 

99x 
9Ax 

9Bx 


2432 
2448 
2464 
2480 


2433 
2449 
2465 
2481 


2434 
2450 
2466 
2482 


2435 
2451 
2467 
24 83 


2436 
2452 
2468 
2484 


2437 
2453 
2469 
2485 


2438 
2454 
2470 
2486 


2439 
2455 
2471 
2487 


2440 
2456 
2472 
2488 


2441 
2457 
2473 
2489 


2442 
2458 
2474 
2490 


2443 
2459 
2475 
2491 


2444 
2460 
2476 
2492 


2445 
2461 
2477 
2493 


2446 
2462 
2478 
24 94 


2447 
2463 
2479 
2495 


9Cx 
9Dx 
9Ex 
9Fx 


2496 
2512 
2528 
2544 


2497 
2513 
2529 
2545 


2498 
2514 
2530 
2546 


2499 
2515 
2531 
2547 


2500 
2516 
2532 
2548 


2501 
2517 
2533 
2549 


2502 
2518 
2534 
2550 


2503 
2519 
2535 
2551 


2504 
2520 
2536 
2552 


2505 
2521 
2537 
2553 


2506 
2522 
2538 
2554 


2507 
2523 
2539 
2555 


2508 
2524 
2540 
2556 


2509 
2525 
2541 
2557 


2510 
2526 
2542 
2558 


2511 
2527 
2543 
2559 


AOx 
A1x 
A2x 
A3x 


2560 
2576 
2592 
2608 


2561 
2577 
2593 
2609 


2562 
2578 
2594 
2610 


2563 
2579 
2595 
2611 


2564 
2580 
2596 
2612 


2565 
2581 
2597 
2613 


2566 
2582 
2598 
2614 


2567 
2583 
2599 
2615 


2568 
2584 
2600 
2616 


2569 
2585 
2601 
2617 


2570 
2586 
2602 
2618 


2571 
2587 
2603 
2619 


2572 
2588 
2604 
2620 


2573 
2589 
2605 
2621 


2574 
2590 
2606 
2622 


2575 
2591 
2607 
2623 


A4x 
A5x 
A6x 
A7x 


2624 
2640 
2656 
2672 


2625 
2641 
2657 
2673 


2626 
2642 
2658 
2674 


2627 
2643 
2659 
2675 


2628 
2644 
2660 
2676 


2629 
2645 
2661 
2677 


2630 
2646 
2662 
2678 


2631 
2647 
2663 
2679 


2632 
2648 
2664 
2680 


2633 
2649 
2665 
2681 


2634 
2650 
2666 
2682 


2635 
2651 
2667 
2683 


2636 

2652 
2668 
2684 


2637 
2653 
2669 
2685 


2638 
2654 
2670 
2686 


2639 
2655 
2671 
2687 


A8x 
A9x 
AAx 
ABx 


2688 
2704 
2720 
2736 


2689 
2705 
2721 
2737 


2690 
2706 
2722 
2738 


2691 
2707 
2723 
2739 


2692 
2708 
2724 
2740 


2693 
2709 
2725 
2741 


2694 
2710 
2726 
2742 


2695 
2711 
2727 
2743 


2696 
2712 
2728 
2744 


2697 
2713 
2729 
2745 


2698 
2714 
2730 
2746 


2699 
2715 
2731 
2747 


2700 
2716 
2732 
2748 


2701 
2717 
2733 
2749 


2702 
2718 
2734 
2750 


2703 
2719 
2735 
2751 


ACx 
ADx 
AEX 
AFx 


2752 
2768 
2784 
2800 


2753 
2769 
2785 
2801 


2754 
2770 
2786 
2802 


2755 
2771 
2787 
2803 


2756 
2772 
2788 
2804 


2757 
2773 
2789 
2805 


2758 
2774 
2790 
2806 


2759 
2775 
2791 
2807 


2760 
2776 
2792 
2808 


2761 
2777 
2793 
2809 


2762 
2778 
2794 
2810 


2763 
2779 
2795 
2811 


2761' 
2780 
2796 
2812 


7765 
2781 
2797 
2813 


2766 
2782 
2798 
2814 


2767 
2783 
2799 
2815 


BOx 
B1x 
B2x 
B3x 


2816 
2832 
2848 
2864 


281? 
2833 
2849 
2865 


2818 
2834 
2850 
2866 


2819 
2835 
2851 
2867 


2820 
2836 
28S2 
2868 


2821 
2837 
2853 
2869 


2822 
2838 
2854 
2870 


2823 
2839 
2855 
2871 


2824 
2840 
2856 
2872 


2825 
2841 
2857 
2873 


2826 
2842 
2858 
2874 


2827 
2843 
2859 
2875 


2828 
2844 
2860 
2876 


2829 
2845 
2861 
2877 


2830 
2846 
2862 
2878 


2831 
2847 
2863 
2679 


B4x 
B5x 
B6x 
B7x 


2880 
2896 
2912 
2928 


2881 
2897 
2913 
2929 


2882 
2898 
2914 
2930 


2883 
2899 
2915 
2931 


2884 
2900 
2916 
2932 


2885 
2901 
2917 
2933 


2886 
2902 
2918 
2934 


2887 
2903 
2919 
2935 


2888 
2904 
2920 
2936 


2889 
2905 
2921 
2937 


2890 
2906 
2922 
2938 


2891 
2907 
2923 
2939 


2892 
2908 
2924 
2940 


2893 
2909 
2925 
2941 


2894 
2910 
2926 
2942 


2895 
2911 
2927 
2943 


B8x 
B9x 
BAX 
BBx 


2944 
2960 
2976 
2992 


2945 
2961 
2977 
2993 


2946 
2962 
2978 
2994 


2947 
2963 
2979 
2995 


2948 
2964 
2980 
2996 


2949 
2965 
2981 
2997 


2950 
2966 
2982 
2998 


2951 
2967 
2983 
2999 


2952 
2968 
2984 
3000 


2953 
2969 
2985 
3001 


2954 
2970 
2986 
3002 


2955 
2971 
2987 
3003 


2956 
2972 
2988 
3004 


2957 
2973 
2989 
3005 


2958 
2970 
2990 
3006 


2959 
2975 
2991 
3007 


BCx 
BDx 
BEx 
BPx 


3008 
3024 
3040 
3056 


3009 
3025 
3041 
3057 


3010 
3026 
3042 
30S8 


3011 
3027 
3043 
3059 


3012 
3028 
3044 
3060 


3013 
3029 
3045 
3061 


3014 
3030 
3046 
3062 


3015 
3031 
3047 
3063 


3016 
3032 
3048 
3064 


3017 
3033 
3049 
3065 


3018 
3034 
3050 
3066 


3019 
3035 
3051 
3067 


3020 
3036 
3052 
3068 


3021 
3037 
3053 
3069 


3022 
3038 
3054 
3070 


3023 
3039 
3055 
3071 
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X = 


1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


COx 
C1x 
C2x 
C3x 


3072 
3088 
3104 
3120 


3073 
3089 
3105 
3121 


3074 
3090 
3106 
3122 


3075 
3091 
3107 
3123 


3076 
3092 
3108 
3124 


3077 
3093 
3109 
3125 


3078 
3094 
3110 
3126 


3079 
3095 
3111 
3127 


3080 
3096 
3112 
3128 


3081 
3097 
3113 
3129 


3082 
3098 
3114 
3130 


3083 
3099 
3115 
3131 


3084 
3100 
3116 
3132 


JVJ03 

3101 
3117 
3133 


3086 
3102 
3118 
3134 


3087 
3103 
3119 
3135 


C4x 
CSx 
C6x 
C7x 


3136 
1152 
3168 
3184 


3137 
3153 
3169 
3185 


3138 
3154 
3170 
3186 


3139 
3155 
3171 
3187 


3140 
3156 
3172 
3188 


3141 
3157 
3173 
3189 


3142 
3158 
3174 
3190 


3143 
3159 
3175 
3191 


3144 
3160 
3176 
3192 


3145 
3161 
3177 
3193 


3146 
3162 
3178 
3194 


3147 
3163 
3179 
3195 


3148 
3164 
3180 
3196 


3149 
3165 
3181 
3197 


3150 
3166 
3182 
3198 


3151 
3167 
3183 
3199 


C8x 
C9x 
CAx 
CBx 


3200 
3216 
3232 
3248 


3201 
3217 
3233 
3249 


3202 
3218 
3234 
3250 


3203 
3219 
32 35 
3251 


3204 
3220 
3236 
3252 


3205 
3221 
3237 
3253 


3206 
3222 
3238 
3254 


3207 
3223 
3239 
3255 


3208 
3224 
3240 
3256 


3209 
3225 
3241 
3257 


3210 
3226 
3242 
3258 


3211 
3227 
3243 
3259 


3212 
3228 
3244 
3260 


3213 
3229 
3245 
3261 


3214 
3230 
3246 
3262 


3215 
3231 
3247 
3263 


CCx 

CDx 
CEx 
CFx 


3264 
3280 
3296 
3312 


3265 
3281 
3297 
3313 


3266 
3282 
3298 
3314 


3267 
3283 
3299 
3315 


3268 
3284 
3300 
3316 


3269 
3285 
3301 
3317 


3270 
3286 
3302 
3318 


3271 
3287 
3303 
3319 


3272 
3288 
3304 
3320 


3273 
3289 
3305 
3321 


3274 
3290 
3306 
3322 


3275 
3291 
3307 
3323 


3276 
3292 
3308 
3324 


3277 
3293 
3309 
3325 


3278 
3294 
3310 
3326 


3279 
3295 
3311 
3327 


DQx 
D1x 
D2x 
D3x 


3328 
3344 
3360 
3376 


3329 
3345 
3361 
3377 


3330 
3346 
3362 
3378 


3331 
3347 
3363 
3379 


3332 
3348 
3364 
3380 


3333 
3349 
3365 
3381 


3334 
3350 
3366 
3382 


3335 
3351 
3367 
3383 


3336 
3352 
3368 
3384 


3337 
3353 
3369 
3385 


3338 
3354 
3370 
3386 


3339 
3355 
3371 
3387 


3340 
3356 
3372 
3388 


3341 
3357 
3373 
3389 


3342 
3358 
3374 
3390 


3343 
3359 
3375 
3391 


D4x 
D5x 
D6x 
D7x 


3392 
3408 
3424 
3440 


3393 
3409 
3425 
3441 


3394 
3410 
3426 
3442 


3395 
3411 
3427 
3443 


3396 
3412 
3428 
3444 


3397 
3413 
3429 
3445 


3398 
3414 
3430 
3446 


3399 
3415 
3431 
3447 


3400 
3416 
3432 
3448 


3401 
3417 
3433 
3449 


3402 
3418 
3434 
3450 


3403 
3419 
3435 
3451 


3404 
3420 
3436 
3452 


3405 
3421 
3437 
3453 


3406 
3422 
3438 
3454 


3407 
3423 
3439 
3455 


D8x 
D9x 
DAx 
DBx 


3456 
3472 
3488 
3504 


3457 
3473 
3489 
3505 


3458 
3474 
3490 
3506 


34 59 
3475 
3491 
3507 


3460 
3476 
3492 
3508 


3461 
3477 
3493 
3509 


3462 
3478 
3494 
3510 


3463 
3479 
3495 
3511 


3464 
3480 
3496 
3512 


3465 
3481 
3497 
3513 


3466 
3482 
3498 
3514 


3467 
3483 
3499 
3515 


3468 
3484 
3500 
3516 


3469 
3485 
3501 
3517 


3470 
3486 
3502 
3518 


3471 
3487 
3503 
3519 


DCx 

DDx 
QEx 
DFX 


3520 
3536 
3552 
3568 


3521 
3537 
3553 
3569 


3522 
3538 
3554 
3570 


3523 
3539 
3555 
3571 


3524 
3540 
3556 
3572 


3525 
3541 
3557 
3573 


3526 
3542 
3558 
3574 


3527 
3543 
3559 
3575 


3528 
3544 
3560 
3576 


3529 
3545 
3561 
3577 


3530 
3546 
3562 
3578 


3531 
3547 
3563 
3579 


3532 
3548 
3564 
3580 


3533 
3549 
3565 
3581 


3534 
3550 
3566 
3582 


3535 
3551 
3567 
3583 


EOx 
Elx 
E2x 
E3x 


3584 
3600 
3616 
3632 


3585 
3601 
3617 
3633 


3586 
3602 
3618 
3634 


3587 
3603 
3619 
3635 


3588 
3604 
3620 
3636 


3589 
3605 
3621 
3637 


3590 
3606 
3622 
3638 


3591 
3607 
3623 
3639 


3592 
3608 
3624 
3640 


3593 
3609 
3625 
3641 


3594 
3610 
3626 
3642 


3595 
3611 
3627 
3643 


3596 
3612 
3628 
3644 


3597 
3613 
3629 
3645 


3598 
3614 
3630 
3646 


3599 
3615 
3631 
3647 


E4x 
E5x 
E6x 
E7x 


3648 
3664 
3680 
3696 


3649 
3665 
3681 
3697 


3650 
3666 
3682 
3698 


3651 
3667 
3683 
3699 


3652 
3668 
3684 
3700 


3653 
3669 
3685 
3701 


3654 
3670 
3686 
3702 


3655 
3671 
3687 
3703 


3656 
3672 
3688 
3704 


3657 
3673 
3689 
3705 


3658 
3674 
3690 
3706 


3659 
3675 
3691 
3707 


3660 
3676 
3692 
3708 


3661 
3677 
3693 
3709 


3662 
3678 
3694 
3710 


3663 
3679 
3695 
3711 


E8x 
E9x 
EAx 
EBX 


3712 
3728 
3744 
3760 


3713 
3729 
3745 
3761 


3714 
3730 
3746 
3762 


3715 
3731 
3747 
3763 


3716 
3732 
3748 
3764 


3717 
3733 
3749 
3765 


3718 
3734 
3750 
3766 


3719 
3735 
3751 
3767 


3720 
3736 
3752 
3768 


3721 
3737 
3753 
3769 


3722 
3738 
3754 
3770 


3723 
3739 
3755 
3771 


3724 
3740 
3756 
3772 


3725 
3741 
3757 
3773 


3726 
3742 
3758 
3774 


3727 
3743 
3759 
3775 


ECx 
EDx 
EEx 
EFx 


3776 
3792 
3808 
3824 


3777 
3793 
3809 
3825 


3778 
3794 
3810 
3826 


3779 
37 95 
3811 
3827 


3780 
3796 
3812 
3828 


3781 
3797 
3813 
3829 


3782 
3798 
3814 
3830 


3783 
3799 
3815 
3831 


3784 
3800 
3816 
3832 


3785 
3801 
3817 
3833 


3786 
3802 
3818 
3834 


3787 
3803 
3819 
3835 


3788 
3804 
3820 
3836 


3789 
3805 
3821 
3837 


3790 
3806 
3822 
3838 


3791 
3807 
3823 
3839 


FOx 
Fix 
F2x 
F3x 


3840 
3856 
3872 
3888 


3841 
3857 
3873 
3889 


3842 
3858 
3874 
3890 


3843 
3859 
3875 
3891 


3844 
3860 
3876 
3892 


3845 
3861 
3877 
3893 


3846 
3862 
3878 
3894 


3847 
3863 
3879 
3895 


3848 
3864 
3880 
3896 


3849 
3865 
3881 
3897 


3850 
3866 
3882 
3898 


3851 
3867 
3883 
3899 


3352 
3868 
3884 
3900 


3853 
3869 
3885 
3901 


3854 
3870 
3886 
3902 


3855 
3871 
3887 
3903 


F4x 
F5x 
F6x 
F7x 


3904 
3920 
3936 
3952 


3905 
3921 
3937 
3953 


3906 
3922 
3938 
3954 


3907 
3923 
3939 
3955 


3908 
3924 
3940 
3956 


3909 
3925 
3941 
3957 


3910 
3926 
3942 
3958 


3911 
3927 
3943 
3959 


3912 
3928 
3944 
3960 


3913 
3929 
3945 
3961 


3914 
3930 
3946 
3962 


3915 
3931 
3947 
3963 


3916 
3932 
3948 
3964 


3917 
3933 
3949 
3965 


3918 
3934 
3950 
3966 


3919 
3935 
3951 
3967 


F8x 
F9x 
FAX 

FBX 


3968 
3984 
4000 
4016 


3969 
3985 
4001 
4017 


3970 
3986 
4002 
4018 


3971 
3987 
4003 
4019 


3972 
3988 
4004 
4020 


3973 
3989 
4005 
4021 


3974 
3990 
4006 
4022 


3975 
3991 
4007 
4023 


3976 
3992 
4008 
4024 


3977 
3993 
4009 
4025 


3978 
3994 
4010 
4026 


3979 
3995 
4011 
4027 


3980 
3996 
4012 
4028 


3981 
3997 
4013 
4029 


3982 
3998 
4014 
4030 


3983 
3999 
4015 
4031 


FCx 

FDx 
FEx 
FFx 


4032 
4048 
4064 
4080 


4033 
4049 
4065 
4081 


4034 
4050 
4066 
4082 


4035 
4051 
4067 
4083 


4036 
4052 
4068 
4084 


4037 
4053 
4069 
4085 


4038 
4054 
4070 
4086 


4039 
4055 
4071 
4087 


4040 
4056 
4072 
4088 


4041 
4057 
4073 
4089 


4042 
4058 
4074 
4090 


4043 
4059 
4075 
4091 


4044 
4060 
4076 
4092 


4045 
4061 
4077 
4093 


4046 
4062 
4078 
4094 


4047 
4063' 
4079 
4095 
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Appendix C. Machine Instruction Format 



o 



T 1 

AFFLICAELE INSTRUCTIONS 



h- 



BASIC MACHINE FORMAT 



ASSEMBLER CFERAND 
FIELD FORMAT 



RR 



I— + 



r t — t — i 

I 8 |4. |4 | 

| Operation | | | 
| Code |R1|R2| 

L JL X J 

r T T 1 

I 8 | 4 |4 | 

{Operation} { J 
| Code |M1|R2| 

L X J. J 

r 1 t — i 

I 8 |4 | | 

| Operation | | | 
| Code |R1| | 

L X JL J 

r 1 1 

I 8 | 8 | 

| Operation | | 

J Code | I | 

L J. J 



R1, R2 



M1,R2 



R1 



Ml RR instructions 
except ECR, SPM, and SVC 



ECR 



SPM 



SVC 



(See Notes 1, 6, 8, and 9) 



RX 



r T T T T 1 

| 8 |4 |4 |4 | 12| 
| Operation | | | | | 
| Code |R1|X2|B2|D2| 

L J. X X X J 

T T T T T 1 

| 8 |4 \H \U 12 | 

| Operation! I I I I 
| Code |M1|X2|B2|D2| 

L X X X X J 



L—X 



R1,D2 (X2,B2) 
R1,D2 ( # B2) 
R1,S2 (X2) 
R1,S2 

M1,D2, (X2,B2) 
M1,D2 (,B2) 
M1 r S2 (X2) 
M1, S2 
(See Notesi, 6, 8, and 9) 



Ml RX instructions 
except EC 



EC 



RS 



r T T T T 1 

| 8 |4 |4 |4 | 12| 

lODerationj I I I I 
j ' Code |R1|R3|B2|D2| 

L JL J. i. J. J 



r r — t — t — t — t 

I 8 | a | |4 |12| 

| Operation | I I I I 
| Code | R1 | |B2|D2| 

L J J J. J J 

r T T T T 1 

I 8 |4 |4 |4 |12| 

| Operation J I I I I 
j Code |R1|M3|B2|D2| 

L J. JL JL JL 1 



R1,R3,D2 (B2) 
R1,R3,S2 



R1,D2 (B2) 
R1,S2 



EXH , EXL E , LM , STM , LCTL , 
STCTL 



All shift instructions 



l — x. 



R1,M3 f D2 (B2) 
R1,M3,S2 
(See Notes 1-3, 7, 8, 
and 9) 



ICM,STCM,CLM 
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BASIC MACHINE FORMAT 



l~i 



r t t — i 1 

I 8 | 8 |4 |12| 
| Operation | | | | 
| Code | 12 |B1|D1| 
i x x j I 



ISI! 



I 8 | 

| Operation | 
| Code j 
l x. 



T— 1 1 

I* M2| 
I I I 
|B1|D1| 

-X X I 



r — - t 1 1 

I 16 |4 |12| 
J Two- byte J | | 
JOperation Code |B1|D1| 
l ..j j I 



h-4- 



\ss 



r _- .___ _____________ — __J.__J.__J 

I 8 |4 |4 |4 | 12|4 | 12f 
|Operation| | | | | | I 
| Code |L1|L2|B1|D1|B2|D2| 

L__ X X X X X 1 I 



r ——.—.— t~~i ~ T""~r — ~i 
| 8 | 8 |4 | 12| 4 j 12| 
| Operation | I I I I I 
| Code | L |B1|D1|B2|D2| 
l x x — j i i I 

r t — r — t — r — i — i 1 

j 8 |4 | 4 |4 | 12|4 j 12| 

| Operation | I I I I I I 
| Code |L1|I3|B1|D1|B2|D2| 

L X X X J X X.-J 



ASSEMBLER OPERAND 
FIELD FORMAT 



D1 (B1) ,12 
S1,I2 



D1 (B1) 
S1 



D1 (B1) 
S1 

(See Notes 2, 3, 6, 7, 8, 

and 10) 



D1 (L1,B1) ,D2 (L2,B2) 
S1 (L1) ,S2 (L2) 



D1 (L,B1) ,D2 (B2) 
S1 (L) f S2 
(See Notes 2, 3, 5, and 7) 

D1 (L1,B1) ,D2 (B2) ,13 
S1 (L1) ,S2 f l3 
S1,S2,I3 

(See Notes 2 r 3, 5, 6, 7, 

and 10) 



APPLICABLE INSTRUCTIONS 



All SI instructions 
except those listed 
for other SI formats 



LPSW,SSM,TIO,TCH 
TS 



SCK,STCK,STIDP,STIDC, 
SIO r SIOF, HIO, HDV 



PACK, UNPK, MVO, AP, 
CP r DP,MP,SP,ZAP 



NC,OC,XC,CLC,MVC,MVN, 
MVZ , TR , TRT , ED , EDMK 



SRP 



L__X. 
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Notes for Appendix C . 

1. R1 , R2, and R3 are absolute expressions that specify general or floating-point 
registers. The general register numbers are through 15; floating-point register 
numbers are 0, 2, 4, and 6. 

2. D1 and D2 are absolute expressions that specify displacements. A value of 0-4095 
may be specified. 

3. B1 and B2 are absolute expressions that specify base registers. Register numbers 
0-15. 

4. X2 is an absolute expression that specifies an index register. Register numbers 
are 0-15. 

5. L, L1, and L2 are absolute expressions that specify field lengths. An L expression 
can specify a value of 1-256. L1 and L2 expressions can specify a value of 1-16. 
In all cases, the assembled value will be one less than the specified value. 

6. I, 12, and 13 are absolute expressions that provide immediate data. The value of I 
and 12 may be 0-255. The value of 13 may be 0-9. 

7. S1 and S2 are absolute or relocatable expressions that specify an address. 

8. RR, RS, and SI instruction fields that are blank under BASIC MACHINE FORMAT are not 
examined during instruction execution. The fields are not written in the symbolic 
operand, but are assembled as binary zeros. 

9. M1 and M3 specify a 4-bit mask. 

10. In IBM System/370 the HIO, HDV, SIO, and SIOF operation codes occupy one byte and 
the low order bit of the second byte. In all other systems the HIO and SIO 
operation codes occupy only the first byte of the instruction. 



o 
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Appendix D. Machine Instruction Mnemonic Operation Codes 



O 



Figure 14 lists all machine operation codes 
and their associated assembler instructions 
and mnemonics in operation code order. 

Figure 16 contains the mnemonic 
operation codes for all machine 
instructions that can be represented in 
assembler language, including extended 
mnemonic operation codes. It is in 
alphabetic order by instruction. Indicated 
for each instruction are both the mnemonic 
and machine operation codes, explicit and 
implicit operand formats, program 
interruptions possible, and condition code 
set. 

The column headings in this appendix and 
the information each column provides 
follow. 

Instructions . This column contains the 
name of the instruction associated with the 
mnemonic operation code. 

Mnemonic Operation Code . This column gives 
the mnemonic operation code for the machine 
instruction. This is written in the 
operation field when coding the 
instruction. 

Machine Operation Code . This column 
contains the hexadecimal equivalent of the 
actual machine operation code. The 
operation code will appear in this form in 
most storage dumps and when displayed on 
the system control panel. For extended 
mnemonics, this column also contains the 
mnemonic code of the instruction from which 
the extended mnemonic is derived. 



registers in operands one, two, and three 
respectively. X2 indicates a general 
register used as an index register in the 
second operand. Instructions which require 
an index register (X2) but are not to be 
indexed are shown with a replacing X2 . 
L, L1, and L2 indicate lengths for either 
operand, operand one, and operand two 
respectively. M1 and M3 indicate four bit 
masks in operands one and three. I, 12, 
and I 3 indicate immediate data eight bits 
long (I and 12) , or four bits long (1 3) . 

For the explicit format, D1 and D2 
indicate a displacement and B1 and B2 
indicate a base register for operands one 
and two. 

For the implicit format, D1, B1 , and D2 , 
B2 are replaced by S1 and S2 which indicate 
a storage address in operands one and two. 



Type of Instruction . This column gives the 
basic machine format of the instruction 
(RR, RX, SI, or SS) . If an instruction is 
included in a special feature or is an 
extended mnemonic, this is also indicated. 

Program Interruptions Possible . This 
column indicates the possible program 
interrupts for this instruction. The 
abbreviations used are: A- Addressing , 
S- Specification, Ov-Overflow, P-Protection, 
Op-Operation (if feature is not installed) 
and Other-other interruptions which are 
listed. The type of overflow is indicated 
by: D-Decimal, E-Exponent, or F-Fixed 
Point. 






Operand Format . This column shows the 
symbolic format of the operand field in 
both explicit and implicit form. For both 
forms, R1, R2, and R3 indicate general 



Condition Code Set . The condition set as a 
result of this instruction is indicated in 



this column, 
figure.) 



(See legend following the 
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j RR Format 

j ( 
j ( 





Operation 








Code 


Name 


Mnemonic 


Remarks { 










00 








01 








02 








03 








04 


Set Program Mask 


SPM 




05 


Branch and Link 


BALR 




06 


Branch on Count 


BCTR 




07 


Branch on Condition 


BCR 




08 


Set Storage Key 


SSK 




09 


Insert Storage Key 


ISK 




0A 


Supervisor Call 


SVC 




0B 








OC 








0D 








OE 


Move Long 


MVCL 


System/370 | 
only j 


OF 


Compare Logical Long 


CLCL 


System/370 | 
only | 


10 


Load Positive 


LPR 




11 


Load Negative 


LNR 




12 


Load and Test 


LTR 




13 


Load Complement 


LCR 




14 


AND 


NR 




15 


Compare Logical 


CLR 




16 


OR 


OR 




17 


Exclusive OR 


XR 




18 


Load 


LR 




19 


Compare 


CR 




1A 


Add 


AR 




1B 


Subtract 


SR 




1C 


Multiply 


MR 




1D 


Divide 


DR 




1E 


Add Logical 


ALR 




1F 


Subtract Logical 


SLR 




20 


Load Positive (Long) 


LPDR 




21 


Load Negative (Long) 


LNDR 




22 


Load and Test (Long) 


LTDR 




23 


Load Complement (Long) 


LCDR 




24 


Halve (Long) 


HDR 




25 


Load Rounded (Extended to Long) 


LRDR 


85 , 195, j 
System/370 j 


26 


Multiply (Extended) 


MXR 


85,195, J 
System/370 j 


27 


Multiply (Long to Extended) 


MXDR 


85,195 | 
System/370 j 


28 


Load (Long) 


LDR 




29 


Compare (Long) 


CDR 




2A 


Add Normalized (Long) 


ADR 




2B 


Subtract Normalized 


SDR 




2C 


Multiply (Long) 


MDR 




2D 


Divide (Long) 


DDR 




2E 


Add Unnormalized (Long) 


AWR 




2F 


Subtract Unnormalized (Long) 


oWK 




30 


Load Positive (Short) 


LPLR 




31 


Load Negative (Short) 


LNER 




32 


Load and Test (Short) 


LTER 




33 


Load Complement (Short) 


LCER 





o 



xJ 



X I J J 



Figure 16. List of Machine Instructions by Operation Code (Part 1 of 5) 
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| RR Format 
L 














1 
__._ J 


r — — 7 — 


— I — 






r~ 




— T - 




j Operation 








1 








| Code 


__x 


Name 




1 

L_ 


Mnemonic 


L 


Remarks j 
_ j 


1 


— -f.— 






f- 




— r 




| 34 




Halve (Short) 






HER 






| 35 




Load Rounded (Long to 


Short) 




LRER 




85,195, | 
System/370 j 


| 36 




Add Normalized (Extended) 




AXR 




85,195, | 
















System/370 | 


| 37 




Subtract Normalized (Extended) 




SXR 




85,195, | 
















System/370 | 


| 38 




Load (Short) 






LER 






| 39 




Compare (Short) 






CER 






| 3A 




Add Normalized (Short) 






AJEi\ 






| 3B 




Subtract Normalized (Short) 




SER 






1 3C 




Multiply (Short) 






MER 






1 3D 




Divide (Short) 






DER 






| 3E 




Add Unnormalized (Short) 




AUR 






| 3F 




Subtract Unnormalized 


(Short) 




SUR 


L_ 


J 


r — " — 


— -J.— 






j.— 








| RX Format 


.— X— . 






_ J,_ 




-_- L_ 


4 


r — 


— f— 






-J— 




T 




| 40 




Store Ha If word 






STH 






| 41 




Load Address 






LA 






| 42 




Store Charater 






STC 






| 43 




Insert Character 






IC 






| 44 




Execute 






EX 






| 45 




Branch and Link 






BAL 






| 46 




Branch on Count 






BCT 






| 47 




Branch on Condition 






BC 






| 48 




Load Ha If word 






LH 






| 49 




Compare Ha If word 






CH 






| 4A 




Add Halfword 






AH 






| 4B 




Subtract Halfword 






SH 






| 4C 




Multiply Halfword 






MH 






| 4D 
















j 4E 




Convert to Decimal 






CVD 






j 4F 




Convert to Binary 






CVB 






| 50 




Store 






ST 






I 51 
















I 52 
















I 53 
















| 54 




AND 






N 






| 55 




Compare Logical 






CL 






| 56 




OR 













I 57 




Exclusive OR 






X 






I 58 




Load 






L 






I 59 




Compare 






C 






| 5A 




Add 






A 






I 5B 




Subtract 






S 






I 5C 




Multiply 






M 






| 5D 




Divide 






D 






| 5E 




Add Logical 






AL 






| 5F 




Subtract Logical 






SL 






| 60 




Store (Long) 






STD 






I 61 
















| 62 
















| 63 
















| 64 
















| 65 

















%J 



Figure 16. List of Machine Instructions by Operation Code (Part 2 of 5) 
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RX Format 









| Operation \ 








j Code j 


Name 


Mnemonic j 


Remarks j 


\- i 




1 


-i 


j 66 ; 








1 67 
1 


Multiply (Long to Extended) 


MXD 


85,195, | 
System/370 j 


I 68 


Load (Long) 


LD 




69 


Compare (Long) 


CD 




6A 


Add Normalized (Long) 


AD 




6B 


Subtract Normalized (Long) 


SD ; 




6C 


Multiply (Long) 


MD 




6D 


Divide (Long) 


DD 




6E 


Add Unnormalized (Long) 


AW 




6F 


Subtract Unnormalized (Long) 


SW 




70 


Store (Short) 


STE 




71 








72 








73 








74 








75 








76 








77 








78 


Load (Short) 


LE 




79 


Compare (Short) 


CE 




7A 


Add Normalized (Short) 


AE 




7B 


Subtract Normalized (Short) 


SE 




7C 


Multiply (Short) 


ME ] 




7D 


Divide (Short) 


DE 




7E 


Add Unnormalized (Short) 


AU J 




7F 


Subtract Unnormalized (Short) 


SU 






L J 


L J. J 










RS,SI Format 






I 










80 


Set System Mask 


SSM 


j 


81 






| 


82 


Load PSW 


LPSW 




83 


Diagnose 






84 


Write Direct 


WRD 




85 


Read Direct 


RDD 




86 


Branch on Index High 


BXH 




87 


Branch on Index Low or Equal 


BXLE 




88 


Shift Right Single Logical 


SRL 




89 


Shift Left Single Logical 


SLL 




8A 


Shift Right Single 


SRA 




8B 


Shift Left Single 


SLA 




8C 


Shift Right Double Logical 


SRDL 




8D 


Shift Left Double Logical 


SLDL 




8E 


Shift Right Double 


SRDA 




8F 


Shift Left Double 


SLDA 




90 


Store Multiple 


STM 




91 


Test under Mask 


TM 




92 


Move (Immediate) 


MVI 




93 


Test and Set 


TS 




94 


AND (Immediate) 


NI 




95 


Compare Logical (Immediate) 


CLI 




95 


OR (Immediate) 


01 




97 


Exclusive OR (Immediate) 


XI 




98 


Load Multiple 


LM 




99 








9A 








9B 









o 



Figure 16. List of Machine Instructions by Operation Code (Part 3 of 5) 
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I RS, SI Format 



Operation 
Code 



9C 

9D 
9E 
9F 
AO 
A1 
A2 
A3 
A4 
A5 
A6 
A7 
A8 
A9 
AA 
AB 
AC 
AD 
AE 
AF 



BO 
B1 
B2 
B3 
B4 
B5 
B6 

B7 

B8 
B9 
BA 
BB 
BC 
BD 



BE 
BF 



SS Format 



CO 
C1 
C2 
C3 
C4 
C5 
C6 
C7 
C8 
C9 
CA 
CB 
CC 



Name 



Start I/O, start I/O Fast Release 

Test I/O 

Halt I/O, Halt Eevice 

Test Channel 



Monitor Call 



(First byte of two-byte operation codes) 

Store Control 
Load Control 



Compare Logical Characters 
under Mask 

Store Characters under Mask 

Insert Characters under Mask 



Mnemonic 



SIO,SIOF 
TIC 

HIC,HEV 
TCH 



MC 



STCTL 
LCTL 



Remarks 



See Note 2 
See Note 1 



System/ 370 
only 



See Note 3 



System/370 
only 

System/ 370 
only 



CLM 


System/ 3 70 




only 


STCM 


System/ 370 




only 


I CM 


System/ 370 




only 



Figure 16. List of Machine Instructions by Operation Code (Fart 4 of 5) 
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I SS Format 

F 

Operation 
Code 



CD 
CE 
CF 
DO 
D1 
D2 
D3 
D4 
D5 
D6 
D7 
D8 
D9 
DA 
DB 
DC 
DD 
DE 
DF 

EO 
E1 
E2 
E3 
E4 
E5 
E6 
E7 
E8 
E9 
EA 
EB 
EC 
ED 
EF 

FO 

F1 
F2 
F3 
FU 
F5 
F6 
F7 
F8 
F9 
FA 
FB 
FC 
FD 
FE 
FF 



Name 



Move Numerics 

Move (Characters) 

Move Zones 

AND (Characters) 

Compare Logical (Characters) 

OR (Characters) 

Exclusive OR (Characters) 



Translate 

Translate and Test 

Edit 

Edit and Mark 



Shift and Round Decimal 

Move with Offset 

Pack 

Unpack 



Zero and Add Decimal 
Compare Decimal 
Add Decimal 
Subtract Decimal 
Multiply Decimal 
Divide Decimal 



Mnemonic 



MVN 

MVC 

MVZ 

NC 

CLC 

OC 

XC 



TR 
TRT 
ED 
EDMK 



SRP 

MVO 

PACK 

UNPK 



ZAP 

CP 

AP 

SP 

MP 

DP 



Remarks 



H 



H 



System/370 
only 



u 



Figure 16. List of Machine Instructions by Operation Code (Part 5 of 5) 



Note 1 : On the Model 195 and System/370 machines, the machine operations for 
Halt Device and Halt I/O are as follows: 



#" T >\ 



128 



o 



f~1001 1110 XXXX XXXO | Halt I/O H10 

I J 



r 1 

j 1001 1110 XXXX XXX 1 j Halt Device HDV 

L J 

(X denotes an ignored bit position) 
On other System/360 machines the Halt I/O operation code is: 



r 








| 1001 


1110 


XXXX 


XXXX j 











The Halt Device instruction does not exist under this system; the second byte is 
completely ignored. 

Note 2 : Under the System/370 architecture the machine operations for Start I/O and 
Start I/O Fast Release are as follows: 



r 1 

| 1001 1100 XXXX XXXO | Start I/O SIO 

L J 

r 1 

j 1001 1100 XXXX XXX 1 j Start I/O Fast Release SIOF 

t J 

(X denotes an ignored bit position) 

Under System/360 the Start I/O code is: 



r i 

| 1001 1100 XXXX XXXX | 
t J 

The Start I/O Fast Release instruction does not exist under this system- The second 
byte is completely ignored. 

Note 3: The following operation codes occupy two bytes of Si-type instructions. They 
can be used on System/370 machines only. 



r~ — ~ — ■ 


" T 










| Operation 


I 




I 




I 


| Code 


I 


Name 


I 

4 


Mnemonic 


I 
i 


r ~ — 


" T * 










| B202 


I 


Store CPU ID 


I 


STIDP 


1 


| B203 


I 


Store Channel ID 


I 


STIDC 


1 


| B204 


I 


Set Clock 


I 


SCK 


1 


| B205 


I 


Store Clock 


I 


STCK 


1 















The special Model 85, Model 195, and System/ 370 instructions are supported only by the 
DOS Assembler D, 14K variant. 
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Mnemonic 


Machine 




Operand Format | 






Operation 


Operation 








j Instruction 


Code 


Cod 


e 




Explicit 


Implicit j 


1- 
















I— 


T { 


|Add 




A 


5A 






R1,D2(X2,B2) orRl,D2(,B2) 


R1,S2 (X2) or R1,S2J 


|Add 




AR 


1A 






R1,R2 






|Add Decimal 


AP 


FA 






D1 (L1,B1) ,D2 (L2,B2) 


S1 (L1) ,S2 (L2) or | 


















S1,S2 j 


|Add Half word 


AH 


4A 






R1,D2 (X2,B2) or 


R1,D2 (,B2) 


R1,S2 (X2)or R1,S2 j 


|Add Logical 


AL 


5E 






R1,D2 (X2,B2) or 


R1,D2 (,B2) 


F1,S2 (X2) or R1,S2J 


|Add Logical 


ALR 


1E 






R1,R2 






JAdd Normalized, 
















| Extended 




AXR 


36 






R1,R2 






|Add Normalized, Long 


AD 


6A 






R1,D2 (X2,B2) or 


R1,D2 (,B2) 


R1,S2 (X2)or R1,S2 | 


|Add Normalized, Long 


ADR 


2A 






R1,R2 






jAdd Normalized, Short 


AE 


7A 






R1,D2 (X2,B2) or 


R1,D2 (,B2) 


R1,S2 (X2)or R1,S2 \ 


|Add Normalized, Short 


AER 


3A 






R1,R2 






|Add Unnormalized,Long 


AW 


6E 






R1,D2 (X2,B2) or 


R1,D2 (,B2) 


R1,S2 (X2)or R1,S2 | 


JAdd Unnormalized,Long 


AWR 


2E 






R1,R2 






|Add Unnormalized, 
















j Short 




AU 


7E 






R1,D2 (X2,B2) or 


R1,D2 (,B2) 


R1 ,S2 (X2)or R1 ,S2 | 


|Add Unnormalized, 
















| Short 




AUR 


3E 






R1,R2 






|And Logical 


N 


54 






R1,D2 (X2,B2) or 


R1,D2 (,B2) 


R1,S2 (X2)or R1,S2 | 


|And Logical 


NC 


D4 






D1 (L,B1) ,D2 (B2) 




S1 (L) ,S2 or S1,S2 | 


j And Logical 


NR 


14 






R1,R2 






(And Logical Immediate 


NI 


94 






D1 (B1) ,12 




S1,I2 | 


j Branch and Link 


BAL 


45 






R1,D2 (X2,B2) or 


R1,D2 (,B2) 


R1,S2 (X2)or R1, S2 | 


| Branch and Link 


BALR 


05 






R1,R2 






j Branch on 


Condition 


BC 


47 






M1,D2(X2,B2) or M1,D2(,B2) 


M1,S2,(X2) or J 


















M1,S2 | 


j Branch on 


Condition 


BCR 


07 






M1,R2 






j Branch on 


Count 


BCT 


46 






R1,D2 (X2,B2) or 


R1,D2 (,B2) 


R1,S2 (X2)or R1,S2 | 


j Branch on 


Count 


BCTR 


06 






R1,R2 






| Branch on 


Equal 


BE 


47 


(BC 


8) 


D2 (X2,B2) or D2 


(,B2) 


S2 (X2) or S2 | 


j Branch on 


High 


BH 


47 


(BC 


2) 


D2 (X2,B2) or D2 


(,B2) 


S2 (X2) or S2 | 


(Branch on 


Index High 


BXH 


86 






R1,R3,D2 (B2) 




R1,R3,S2 j 


j Branch on 


Index Low 
















|or Equal 




BXLE 


87 






R1,R3,D2 (B2) 




R1,R3,S2 j 


{Branch on 


Low 


BL 


47 


(BC 


«) 


D2 (X2,B2) or D2 


(,B2) 


S2 (X2) or S2 j 


j Branch if 


Mixed 


BM 


47 (BC 


*») 


D2 (X2,B2) or D2 


(,B2) 


S2 (X2) or S2 j 


j Branch on 


Minus 


BM 


47 (BC 


4) 


D2 (X2,B2) or D2 


(,B2) 


S2 (X2) or S2 | 


| Branch on 


Not Equal 


BNE 


47 


(BC 


7) 


D2 (X2,B2) or D2 (,B2) 


S2 (X2) or S2 | 


j Branch on 


Not High 


BNH 


47 


(BC 


13) 


D2 (X2,B2) or D2 


(,B2) 


S2 (X2) or S2 | 


j Branch on 


Not Low 


BNL 


47 


(BC 


11) 


|D2 (X2,B2) or D2 (,B2) 


S2 (X2) or S2 | 


j Branch on 


Not Minus 


BNM 


47 


(BC 


11) 


D2 (X2,B2) or D2 


(,B2) 


S2 (X2) or S2 j 
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o 



Instruction 



Branch on Not Ones 
Branch on Not Plus 
Branch on Not Zeros 
Branch if Ones 
Branch on Overflow 



Branch on Plus 
Branch if Zeros 
Branch on Zero 
Branch Unconditional 
Branch Unconditional 

Compare Algebraic 
Compare Algebraic 
Compare Decimal 

Compare Halfword 
Compare Logical 

Compare Logical 

Compare Logical 

Compare Logical 
Characters under 
Mask 

Compare Logical 

Immediate 

Compare Logical Long 

Compare, Long 

Compare, Long 

Compare , Short 
Compare, Short 
Convert to Binary 
Convert to Decimal 



Mnemonic 

Operation 

Code 



BNO 

BNP 

BNZ 

BO 

BO 



BP 

BZ 

BZ 

B 

BR 

C 

CR 
CP 

CH 
CL 

CLC 
CLR 



CLM 

CLI 

CLCL 

CD 

CDR 

CE 
CER 
CVB 
CVD 



Machine 

Operation 

Code 



47 (BC 
47 (BC 
47 (BC 
47 (BC 
47 (BC 



14) 

13) 

7) 

D 

1) 



47 (BC 2) 
47 (BC 8) 
47 (BC 8) 
47 (BC 15) 
07 (BCR 15) 

59 
19 
F9 

49 
55 

D5 

15 



BD 

95 

OF 
69 
29 

79 
39 

4F 
4E 



Operand Format 
Explicit Implicit 



D2 (X2,B2) or 
D2 (X2,B2)or 
D2 (X2,B2) or 
D2 (X2,B2)or 
D2 (X2,B2)or 



D2 (X2,B2) or 
D2 (X2,B2)or 
D2 (X2,B2)or 
D2 (X2,B2) or 
R2 



D2 (,B2) 
D2 (,B2) 
D2 (,B2) 
D2 (,B2) 
D2 (,B2) 



D2 (, B2) 
D2 (,B2) 
D2 (,B2) 
D2(,B2) 



R1,D2 (X2,B2) or R1,D2 

R1,R2 

D1 (L1,B1) ,D2 (L2,B2) 

R1,D2 (X2.,B2) or R1,D2 
R1,D2 (X2,B2)or R1,D2 

D1 (L,B1) ,D2 (B2) 

R1,R2 



R1,M3,D2, (B2) 

D1 (B1) ,12 

R1,R2 

R1,D2 (X2,B2) or R1,D2 

R1,R2 

R1,D2 (X2,B2) or R1,D2 

R1,R2 

R1,D2 (X2,B2) or R1,D2 

R1,D2 (X2,B2)or R1,D2 



(,B2) 



(,B2) 
(,B2) 



(rB2) 



(,B2) 

(,B2) 
(,B2) 



S2 (X2) 


or 


S2 


S2 (X2) 


or 


S2 


S2 (X2) 


or 


S2 


S2 (X2) 


or 


S2 


S2 (X2) 


or 


S2 


S2 (X2) 


or 


S2 


S2 (X2) 


or 


S2 


S2 (X2) 


or 


S2 


S2 (X2) 


or 


S2 



R1,S2 (X2) or R1 r S2 

S1 (L1) ,S2 (L2) or 

S1,S2 

R1,S2 (X2)or R1,S2 

R1,S2 (X2)or R1 ,S2 

S1 (L) ,S2 or S1,S2 



R1,M3,S2 
S1,I2 

R1,S2(X2) or R1,S2 

R1,S2 (X2) or R1.S2 

R1,S2 (X2) or R1,S2 

R1,S2 (X2) or R1,S2 
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Instruction 

Add 

Add 

Add Decimal 

Add Ha If word 

Add Logical 



Add Logical 

Add Normalized, 

Extended 

Add Normalized, Long 

Add Normalized, Long 

Add Normalized, Short 

Add Normalized, Short 



Type of 
Instruction 

RX 

RR 

SS, Decimal 

RX 

RX 



RR 

RR, Floating Pt. 
RX, Floating Pt. 
RR, Floating Pt. 
RX, Floating Pt. 
RR, Floating Pt. 



Add Unnormalized, 




Long 


RX, Floating Pt. 


Add Unnormalized, 




Long 


RR, Floating Pt. 


Add Unnormalized, 




Short 


RX, Floating Pt. 


Add Unnormalized, 




Short 


RR, Floating Pt. 


Add Logical 


RX 


And Logical 


SS 


And Logical 


RR 


And Logical Immediate 


SI 


Branch and Link 


RX 


Branch and Link 


RR 


Branch on Condition 


RX 


Branch on Condition 


RR 


Branch on Count 


RX 


Branch on Count 


RR 


Branch on Equal 


RX , Ext . Mnemonic 


Branch on High 


RX , Ext. Mnemonic 


Branch on Index High 


RS 


Branch on Index Low 




or Equal 


RS 


Branch on Low 


RX, Ext. Mnemonic 


Branch if Mixed 


RX , Ext . Mnemonic 



Branch on Minus 
Branch on Not Equal 
Branch on Not High 
Branch on Not Low 
Branch on Not Minus 



RX , Ext. Mnemonic 
RX , Ext . Mnemonic 
RX, Ext. Mnemonic 
RX, Ext. Mnemonic 
RX, Ext. Mnemonic 



J Program Interrupt, 
j Possible 


Lons 




Condition Code Set 


J 


|A|S|0v|P|0p|0ther 
j i i • ± i _ 


| 00 
_j, 


"T ~t~ — ~t~ ~ — 

| 01 J 10 | 11 
j. _ j • 


"1 

H 


T T T T 

|x| xJF 


T 


— 




~T 

|Sum= 


=0 


"7 "f 

|Sum<0 


r 1 

Sum>0 


Overflow 


III** 








jsum= 


=0 


| SurrKO 


Sum>0 


Overflow 




jxj |D 


xjx 


Data 


|Sum= 


=0 


Sum<0 


Sum>0 


Overflow 




j x j x | F 
jxjxj 








|Sum=0 j SurrKO. 
j Sum=<0(E>| Sum 0<g 


SurrKO 
SurtRQ(D 


Overflow 
Sum n (J) 












|Sum= 


■0®|Sum=0(g! 


Sum=D(J) 


Sum 0© 




j |x|E 


jx 


B, 


c 


|R 




|L 


M 






j xjx|E 


jx 


B, 


c 


|R 




|L 


M 


P 




j jxjE 


jx 




c 


j R 




i ^ 


M 


P 




jxjxJE 


jx 


B, 


c 


|R 




|L 


M 


P 




j | x j j E 


jx 


B, 


c 


|R 




|L 


M 


P 




j xj xJE 


|x 


C 




|R 




|L 


M 


P 




1 l x l E 


jx 


C 




|R 




|L 


M 


P 




j xj xJE 


J x 


c 




|R 




|L 


M 


P 




1 l x l E 


jx 


c 




|R 




|L 


M 


P 




1 x l x l 








1 J 




|K 








1 x l 1 


xj 






1 J 












j xj j 


xj 






I J 

|N 
|N 

|N 
|N 
JN 
JN 
JN 

|N 
JN 

|N 
|N 
JN 

|N 
JN 
JN 
JN 
JN 




IK 
JN 
JN 

|N 
|N 
JN 
|N 
|N 

|N 
JN 

|N 
JN 
JN 

|N 
|N 
|N 
JN 
|N 


N 
N 

N 
N 
N 
N 
N 

N 
N 

N 
N 
N 

N 
N 
N 
N 
N 


N 
N 

N 
N 
N 
N 
N 

N 
N 

N 
N 
N 

N 
N 
N 
N 
N 





o 



.i.-i._i. x_x. 
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n 
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^^jr 




























| Program Interrupt 


ions 












Type of 


j Possible 




Condition Code Set 


Instrucuiun 


r~T~T' 


T T T 


~t — r t 








Instruction 


JA|S|Ov!P!OpjQther 


! oo 


01 


10 


j 11 
















Branch 


on Not Ones 


RX , Ext. Mnemonic | | | 


1 1 1 


|N 


N 


N 


JN 


Branch 


on Not Plus 


RX, Ext. Mnemonic! j j 




|N 


N 


N 


|N 


Branch 


on Not Zeros 


RX, Ext. Mnemonicj J J 




|N 


N 


N 


|N 


Branch 


if Ones 


RX, Ext. Mnemonicj j j 




JN 


N 


N 


JN 


Branch 


on Overflow 


RX, Ext. Mnemonic! j j 




JN 


N 


N 


JN 


Branch 


on Plus 


RX , Ext . Mnemonic j j j 




IN 


N 


N 


|N 


Branch 


if Zeros 


RX, Ext. Mnemonicj j j 




JN 


N 


N 


|N 


Branch 


on Zero 


RX, Ext. Mnemonicj j j 




JN 


N 


N 


JN 


Branch 


Unconditional 


RX, Ext. Mnemonicj j J 




|N 


N 


N 


|N 


Branch 


Unconditional 


RR, Ext. Mnemonicj j j 




JN 


N 


N 


JN 


Compare Algebraic 


RX 


j x i x i 




! z 


AA 


BB 




Compare 


Algebraic 


RR 






|Z 


AA 


BB 




Compare 


Decimal 


SS, Decimal 


j xj j 


| jxj Data 


|Z 


AA 


BB 




Compare 


Ha If word 


RX 


j x | x j 




|2 


AA 


BB 




Compare 


Logical 


RX 


1 X j X j 




1 z 


AA 


BB 




Compare 


Logical 


SS 


1 X j X j 




|z 


AA 


BB 




Compare 


Logical 


RR 


j xj j 




jz 


AA 


BB 




Compare 


Logical 
















Characters under 
















Mask 




RS 


j X j j 


| x j x j 


!XX 


YY 


zz 




Compare 


Logical 
















Immediate 


SI 


j xj j 




|z 


AA 


BB 




Compare 


Logical Long 


RR 


j xjx 


xjx j 


1 z 


AA 


BB 




Compare 


,Long 


RX, Floating 


Pt. j xjx| 


1 i x 1 


1 z 


AA 


BB 




Comapre 


,Long 


RR, Floating 


Pt. j xjxj 


i 1 x 1 


jz 


AA 


BB 




Compare 


,Short 


RX, Floating 


Pt. | xjxj 


1 l x 1 


|z 


AA 


BB 




Compare 


,Short 


RR, Floating 


Pt. j jxj 


j jxj 


jz 


AA 


BB 




Convert 


to Binary 


RX 


| X | X j 


j j JData, 


FJN 


N 


N 


|N 


Convert 


to Decimal 


RX 


1 x l x l 


jxj j 


JN 


N 


N 


JN 



-J._i._J. X-X- 
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Mnemonic 


Machine 


Operand Format | 




Operation 


Operation 






1 Instruction 


Code 


Code 


Explicit 


Implicit j 










(Divide 


D 


5D 


R1,D2(X2,B2) or R1,D2(,B2) 


R1,S2 (X2) or R1,S2J 


j Divide 


DR 


1D 


R1,R2 




j Divide Decimal 


DP 


FD 


D1, (L1,B1) ,D2 (L2,B2) 


S1 (L1) ,S2 (L2) or J 
S1,S2 ( 


| Divide, Long 


DD 


6D 


R1,D2 (X2,B2) ,or R1,D2(,B2) 


R1,S2 (X2) or R1,S2| 


j Divide, Long 


DDR 


2D 


R1,R2 




j Divide, Short 


DE 


7D 


R1,D2 (X2,B2) or R1,D2(,B2) 


R1,S2 (X2) or R1,S2| 


J Divide, Short 


DER 


3D 


R1,R2 




|Edit 


ED 


DE 


D1 (L,B1) ,D2 (B2) 


S1 (L) ,S2 or S1,S2 | 


j Edit and Mark 


EDMK 


DF 


D1 (L,B1) ,D2 (B2) 


S1 (L) ,S2 or S1,S2 j 


(Exclusive Or 


X 


57 


R1,D2 (X2 r -B2) or Rl,D2{,B2) 


R1,S2 (X2) or Rl,S2j 


| Exclusive Or 


xc 


D7 


D1 (L,B1) ,D2 (B2) 


SI (L) ,S2 or S1,S2 | 


j Exclusive Or 


XR 


17 


R1,R2 




(Exclusive Or 










( Immediate 


X1 


97 


Dl (B1) ,12 


S1,12 | 


j Execute 


EX 


44 


R1,D2(X2,B2) or R1,D2(,B2) 


R1,S2 (X2) or R1,S2| 


(Halve, Long 


HDR 


24 


R1,R2 




j Halve, Short 


HER 


34 


R1,R2 




(Halt Device 


HDV 


9E 1 


D1 (B1) 


SI ( 


JHalt I/O 


HIO 


9E 1 


D1 (B1) 


S1 J 


j Insert Character 


IC 


43 


R1,D2(X2,B2) or R1,D2(,B2) 


R1,S2 (X2) or R1,S2| 


(Insert Characters 










(under Mask 


ICM 


BF 


R1,M3,D2 (B2) 


R1,M3,S2 J 


| Insert Storage Key 


ISK 


09 


R1,R2 




(Load 


L 


58 


R1,D2(X2,B2) or R1,D2(,B2) 


R1, S2 (X2) or R1,S2J 


JLoad 


LR 


18 


R1,R2 




(Load Address 


LA 


41 


R1,D2(X2,B2) or R1,D2(,B2) 


R1,S2 (X2) or R1,S2| 


(Load and Test 


LTR 


12 


K l|K/ 




|Load and Test, Long 


LTDR 


22 


R1,R2 




|Load and Test, Short 


LTER 


32 


R1,R2 




(Load Complement 


LCR 


13 


R1,R2 




j Load Complement, Long 


LCDR 


23 


R1,R2 




(Load Complement, Short 


LCER 


33 


R1,R2 




j Load Control 


LCTL 


B7 


R1,R3,D2 (B2) 


R1,R3,S2 ( 


j Load Ha If word 


LH 


48 


R1,D2(X2,B2) or R1,D2(,B2) 


R1,S2 (X2) or R1,S2I 


(Load, Long 


LD 


68 


R1,D2 (X2,B2) or R1,D2(,B2) 


R1,S2 (X2) or R1,S2| 


j Load, Long 


LDR 


28 


R1,R2 




JLoad Multiple 


LM 


98 


R1,R3,D2 (B2) 


R1,R3,S2 | 


(Load Negative 


LNR 


11 


R1,R2 




(Load Negative, Long 


LNDR 


21 


R1,R2 




(Load Negative, Short 


LNER 


31 


R1,R2 




(Load Positive 


LPR 


10 


R1,R2 




(Load Positive, Long 


LPDR 


20 


R1,R2 




(Load Positive, Short 


LPER 


30 


R1,R2 




(Load PSW 


LPSW 


82 


D 1 (B.1) 


S1 | 


(Load Rounded, 










(Extended to Long 


LRDR 


25 


R1,R2 




(Load Rounded, 










(Long to Short 


LRER 


35 


R1,R2 




j Load, Short 


LE 


78 


R1,D2(X2,B2) or R1,D2(,B2) 


R1,S2(X2) or R1,S2| 



V j. j. x j. . — j 

| 1 See Note 1, Figure 16. J 
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J 
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o 



















Mnemonic | 


Machine 


| Operand 


Format 






Ope rati on | 


Operation | 








[instruction 


Code | 


Code 




J Explicit 




Impl 


icit j 


|. 


1 






-4 : 




ii 


| Load, Short 


LER | 


38 




|R1,R2 








| Monitor Call 


MC | 


AF 




|D1 (B1) ,12 




S1,I2 




JMove Characters 


MVC | 


D2 




|D1 (L,B1) ,D2 (B2) 




S1(L) ,S2 


or S1,S2 | 


|Move Immediate 


MVI | 


92 




|D1 (B1) ,12 




S1,I2 




JMove Long 


MVCL | 


OE 




|R1,R2 








|Move Numerics 


MVN 


D1 




|D1 (L,B1) ,D2(B2) 




S1 (L) ,S2 


or S1,S2 1 


JMove with Offset 


MVO | 


F1 




|D1 (L1,B1) ,D2 (L2,B2) 




S1 (L1) ,S2(L2)or | 














S1,S2 




JMove Zones 


MVZ | 


D3 




|D1 (L,B1) ,D2 (B2) 




S1(L) ,S2 


or S1,S2 | 


j Multiply 


M | 


5C 




|R1,D2 (X2,B2) or R1,D2( 


r E2) 


R1,S2 (X2) 


or R1,S2| 


| Multiply 


MR | 


1C 




|R1,R2 








j Multiply Decimal 


MP | 


FC 




|D1 (L1,B1) ,D2 (L2,B2) 




S 1 (L1) ,S2 (L2) or | 














S1,S2 




| Multiply, Extended 


MXR | 


26 




|R1,R2 








(Multiply Halfv*ord 


MH | 


4C 




|R1,D2 (X2,B2) or R1 ,D2 ( 


rE2) 


R1,S2 (X2) 


or R1,S2| 


j Multiply, Long 


MD | 


6C 




|R1,D2 (X2,B2) orRl,D2( 


rE2) 


R1,S2(X2) 


or R1,S2| 


| Multiply , Long 


MDR | 


2C 




|R1,R2 








(Multiply, Long to 
















j Extended 


MXD j 


27 




|R1,D2 (X2,B2) or R1 ,D2 ( 


rB2) 


R1,S2 (X2) 


or R1 (S2) 


j Multiply, Long to 
















(Extended 


MXDR | 


67 




|R1,R2 








| Multiply , Short 


ME j 


7C 




|R1,D2 (X2,B2) orRl,D2( 


rE2) 


R1,S2 (X2) 


or R1,S2| 


(Multiply, Short 


MER | 


3C 




|R1,R2 








(No Operation 


NOP | 


47 (BC 


0) 


|D2 (X2,B2) or D2 (,B2) 




S2(X2) or 


S2 | 



L .- -JL--, t- X X J 
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j Instruction 


Type of 




^_ 


Instruction 




| Divide 


_________________ 

RX 




| Divide 


RR 




j Divide Decimal 


SS, Decimal 




j Divide, Long 


RX, Floating 


Pt. 


(Divide, Long 


RR, Floating 


Pt. 


j Divide, Short 


RX, Floating 


Pt. 


j Divide, Short 


RR, Floating 


Pt. 


JEdit 


SS, Decimal 




(Edit and Mark 


SS, Decimal 




[Exclusive Or 


RX 




j Exclusive Or 


SS 




j Exclusive Or 


RR 




| Exclusive Or 






j Immediate 


SI 




j Execute 


RX 




j Halve, Long 


RR, Floating 


Pt. 


j Halve, Short 


RR, Floating 


Pt. 


|Halt Device 


SI 




JHalt I/O 


SI 




j Insert Character 


RX 




| Insert Characters 






j under Mask 


RS 




| Insert Storage Key 


RR 




|Load 


RX 




(Load 


RR 




|Load Address 


RX 




JLoad and Test 


RR 




|Load and Test, Long 


RR, Floating 


Pt. 


JLoad and Test, Short 


RR, Floating 


Pt. 


JLoad Complement 


RR 




JLoad Complement, Long 


RR, Floating 


Pt. 


JLoad Complement, Short 


RR, Floating 


Pt. 


JLoad Control 


RS 




JLoad Half word 


RX 




J Load, Long 


RX, Floating 


Pt. 


| Load, Long 


RR, Floating 


Pt. 


JLoad Multiple 


RS 




(Load Negative 


RR 




JLoad Negative, Long 


RR, Floating 


Pt. 


JLoad Negative, Short 


RR, Floating 


Pt. 


(Load Positive 


RR 




(Load Positive, Long 


RR, Floating 


Pt. 


(Load Positive, Short 


RR, Floating 


Pt. 


(Load PSW 


SI 




(Load Rounded , Extended 






| to Long 


RR, Floating 


Pt. 


(Load Rounded, Long 






(to Short 


RR, Floating 


Pt. 


j Load , Short 


RX, Floating 


Pt. 


(Monitor Call 


SI 





I Program Interruptions 
I Possible 



Condition Code Set 



j.---- — t-t — t t t t r ^1 



T~T T-T T T T - 

AJS|0vjP(0p(0ther j 00 j 01 

+-T-T— T-T— T T + T 



x jx 








F 


N 


N 


N j 


jx 








F 


N 


N 


N j 


xjx 




X 


X 


D,Data 


N 


N 


N | 


xjx 


E 




X 


B,E 


N 


N 


N j 


jx 


E 




X 


B,E 


N 


N 


N j 


xjx 


E 




X 


B,E 


N 


N 


N | 


jx 


E 




X 


B,E 


N 


N 


N j 


xj 




X 


X 


Data 


S 


T 


U ( 


X j 




X 


X 


Data 


S 


T 


U j 


xjx 










J 


K 




X j 




X 






J 
J 


K 
K 




X j 




X 






J 


K 




xjx 








G 


Way be 


set by 


this in 


jx 






X 




N 


N 


N | 


jx 






X 




N 


N 


N | 










A 


DD 


CC 


AAL j 










A 


DD 


CC 


GG | 


X j 










N 


N 


N J 


X j 




X 


X 




UU 


TT 


SS | 


xjx 






X 


A 


N 


N 


N j 


xjx 










N 

N 
N 
J 


N 

N 
N 
L 


N | 

N | 
N j 
M | 


jx 






X 




R 


L 


M j 


jx 






X 




R 


L 


M j 




F 








P 


L 


M ( 


jx 






X 




R 


L 


M | 


jx 






X 




R 


L 


M j 


xjx 




X 


X 


A 


N 


N 


N j 


xjx 










N 


N 


N j 


xjx 






X 




N 


N 


N j 


jx 






X 




N 


N 


N j 


xjx 










N 
J 


N 
L 


N j 


jx 






X 




R 


L 




jx 


F 




X 




R 
J 


L 


M | 


jx 






X 




R 


L 


M J 


jx 






X 




R 


L 


M ( 


x|x 








A 


CC 


CC 


QQ I 


(X 


E 




X 




N 


N 


N ( 


jx 


E 




X 




N 


N 


N ( 


xjx 






X 




N 


N 


N j 


jx 






X 


G,A 


N 


N 


N j 



N 
N 
N 
N 
N 



^ 



-JL—L-JL J.-.-L. 



structionl 

N 

N 

KK 
KK 
N 



QQ 
N 

N 
N 
N 
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| Program Interrupt 


ions 






I 






(Possible 






Condition Code set 


I 


S Instruction 


Type of 


L_,. ,. ^ 












j 


r T T T T 


"T 


~T T T T 


1 


t _ _ 


Instruction 


|A(SJOv 

- — f-M— i 
Pt.j jxj 


P | Op | Other 
i i 


| 00 j 01 | 10 | 11 
|N |N |N |N 


i 


| Load, Short 


„ 

RR, Floating 


T — 
1 x 


j 


JMove Characters 


SS 


j j xj j 


xj 




|N 


|N 


|N |N 




JMove Immediate 


SI 


i x i i 


xj 




|N 


N 


|N |N 




(Move Long 


RR 


j x|x| 


xjx 




(AAA 


AAB 


| AAC j AAD 




JMove Numerics 


SS 


1 xj j 


xj 




|N 


N 


|N JN 




JMove with Offset 


SS 


j X j j 


xj 




JN 


N 


|N JN 




JMove Zones 


SS 


j xj j 


xj 




|N 


|N 


|N |N 




j Multiply 


Ka 


j xj xj 






JN 


N 


|N |N 




(Multiply 


RR 


j j xj 






|N 


N 


|N |N 




JMultiply Decimal 


SS, Decimal 


jxj xj 


xjx 


JData 


JN 


N 


|N |N 




j Multiply , Extended 


RR, Floating 


Pt.j jxJE 


jx 


|B 


JN 


N 


N |N 




JMultiply Ha If word 


RX 


j | X j | X j 






JN 


N 


|N |N 




JMultiply , Long 


RX, Floating 


Pt. j xj xJE 


jx 


|B 


|N 


|N 


|N |N 




(Multiply , Long 


RR, Floating 


Pt.j jxJE 


jx 


|B 


IN 


JN 


N JN 




JMultiply, Long 


















j to Extended 


RX, Floating 


Pt. jxjxJE 


xjx 


|B 


|N 


|N 


|N |N 




JMultiply , Long 


















j to Extended 


RR, Floating 


Pt. | |x|E 


jx 


|B 


(N 


N 


|N |N 




JMultiply, Short 


RX, Floating 


Pt. j xj xj E 


jx 


|B 


|N 


[N 


|N |N 




(Multiply, Short 


RR, Floating 


Pt. x E 


j x 


|B 


JN 


N 


N |N 




|No Operation 


RX, Ext. Mnemonic | | | 






|N 


N 


|N IN 



















^"\ 
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Mnemonic 


Machine 






Operand 


Format 






Operation 


Operation 
















j Instruction 


Code 


Code 


Explicit 






Implicit j 








































J No Operation 


NOPR 


07 (BCR 0) 


R2 














jor Logical 





56 


R1,D2 (X2,B2) 


or 


R1. 


D2(, 


,B2) 


|R1,S2 (X2) 


or R1 ,S2| 


|0r Logical 


OC 


D6 


D1 (L,B1) ,D2 (B2) 








|S1 (L) ,S2 


or S1 # S2 j 


|0r Logical 


OR 


16 


R1,R2 














jor Logical Immediate 


01 


96 


D1 (B1) ,12 










IS1/I2 




(Pack 


PACK 


F2 


D1 (L1,B1) r D2 


(L2 


rB2) 






|S1 (L1) ,S2 (L2) or j 


















|S1,S2 




(Read Direct 


RDD 


85 


D1 (B1) ,12 










S1,I2 




jset Clock 


SCK 


B204 


D1 (B1) 










| SI 




|Set Program Mask 


SPM 


04 


R1 














jset System Key 


SSK 


08 


R1,R2 














ISet System Mask 


SSM 


80 


D1 (B1) 










[SI 




| Shift and Round 




















j Decimal 


SRP 


F0 


D1 (L1,B1) ,D2 (B2) 


,M3 






S1 (L1) r S2 


,M3 or | 


















S1,S2,M3 




| Shift Left Double 




















| Algebraic 


SLDA 


8F 


R1,D2 (B2) 










|R1,S2 




J Shift Left Double 




















j Logical 


SLDL 


8D 


R1,D2 (B2) 










R1,S2 




| Shift Left Single 




















j Algebraic 


SLA 


8B 


R1,D2 (B2) 










R1,S2 




j Shift Left Single 




















JLogical 


SLL 


89 


R1,D2 (B2) 










R1,S2 




j Shift Right Double 




















JAlgebraic 


SRDA 


8E 


R1,D2 (B2) 










R1,S2 




| Shift Right Double 




















| Logical 


SRDL 


8C 


R1,D2 (B2) 










R1,S2 




| Shift Right Single 




















JAlgebraic 


SRA 


8A 


R1,D2 (B2) 










R1,S2 




j Shift Right Single 




















| Logical 


SRL 


88 


R1,D2 (B2) 










R1 # S2 




| Start I/O 


SIO 


9C 1 


D1 (B1) 










S1 




| Start I/O Fast 




















(Release 


SI OF 


9C 1 


D1 (B1) 










S1 




| Store 


ST 


50 


R1,D2 (X2,B2) « 


or R1,D2 (,B2) 


R1,S2 (X2) 


or R1,S2| 


| Store Channel ID 


STIDC 


B203 


D1 (B1) 










S1 




j Store Character 


STC 


42 


R1,D2 (X2,B2) 


or 


R1. 


D2(, 


B2) 


R1,D2 (X2) 


or R1,S2| 


j Store Characters 




















j under Mask 


STCM 


BE 


R1,M3,D2 (B2) 










R1,M3,S2 




j Store Clock 


STCK 


B205 


D1 (B1) 










S1 




j Store Control 


STCTL 


B6 


R1,R3,D2 (B2) 










R1,R3,S2 




j Store CPU ID 


STIDP 


B202 


D1 (B1) 










SI 




j Store Half word 


STH 


40 


R1,D2 (X2,B2) 


or 


R1, 


D2( ( 


rB2) 


R1,S2 (X2) 


or R1,S2| 


J Store Long 


STD 


60 


R1,D2 (X2,B2) 










R1,S2 (X2) 


or R1,S2| 


j Store Multiple 


STM 


90 


R1,R2,D2 (B2) 










!R1,R2,S2 




j Store Short 


STE 


70 


R1,D2 (X2,B2) 


or 


R1, 


D2(, 


B2) 


R1,S2 (X2) 


or R1,S2| 


j Subtract 


S 


5B 


R 1 , D2 (X2) 










R1,S2 (X2) 


or R1,S2| 


j Subtract 


SR 


1B 


R1,R2 














j Subtract Decimal 


SP 


FB 


D1 (L1,B1) ,D2 (L2 


rB2) 






|S1 (L1) ,S2(L2) or j 


















|S1,S2 




j Subtract Half word 


SH 


4B 


R1,D2 (X2,B2) 


or 


R1, 


D2( ( 


rB2) 


|R1,S2 (X2) 


or R1,S2| 


j Subtract Logical 


SL 


5F 


R1,D2 (X2,B2) 


or 


R1. 


D2(< 


rB2) 


R1,S2 (X2) 


or R1,S2J 


(Subtract Logical 


SLR 


1F 


R1,R2 















|. J. J. X 4 

j 1 See Note 2, Figure 16. 

i 
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o 





Mnemonic 


Machine 


Operand 


Format j 




Operation 


Operation 








j Instruction 

• _ ___ ___ _ i_ 


Code 


Code 


Explicit 




Implicit j 
j 


r ~ r r t 


• — t i 


| Subtract Normalized, 












| Extended 


SXR 


37 


R1,R2 






(Subtract Normalized, 












JLong 


SD 


6B 


R1,D2(X2,B2) or R1,D2( ( 


B2) 


R1,S2 (X2) or R1,S2| 


| Subtract Normalized, 












JLong 


SDR 


2B 


R1,R2 






j Subtract Normalized, 












| Short 


SE 


7B 


R1,D2(X2,B2) or R1,D2(, 


B2) 


R1,S2 (X2) or R1,S2| 


j Subtract Normalized, 












j Short 


SER 


3B 


R1,R2 






j Subtract 












j Unnormalized ,Long 


SW 


6F 


R1,D2(X2,B2) or R1,D2(, 


B2) 


R1,S2 (X2) or R1,S2| 


j Subtract 












j Unnormalized ,Long 


SWR 


2F 


R1,R2 






j Subtract 












j Unnorma liz ed , Short 


SU 


7F 


R1,D2(X2,B2) or R1,D2(, 


B2) 


R1,S2 (X2) or R1,S2| 


J Subtract 












JUnnprmalized, Short 


SUR 


3F 


R1,R2 






| Supervisor Call 


SVC 


OA 


1 






j Test and Set 


TS 


93 


D1 (B1) 




S1 | 


|Test Channel 


TCH 


9F 


D1 (B1) 




S1 | 


|Test I/O 


TIO 


9D 


D1 (B1) 




S1 j 


JTest Under Mask 


TM 


91 


D1 (B1) ,12 




S1,I2 | 


| Trans late 


TR 


DC 


D1 (L,B1) ,D2 (B2) 




S1 (L) ,S2 or S1,S2 j 


j Translate and Test 


TRT 


DD 


D1 (L,B1) ,D2 (B2) 




S1 (L) r S2 or S1,S2 j 


| Unpack 


UNPK 


F3 


D1 (L1,B1) ,D2 (L2,B2) 




S1 (L1) ,S2(L2) or | 
S1,S2 j 


| Write Direct 


WRD 


84 


D1 (B1) ,12 




S1,I2 | 


j Zero and Add Decimal 


ZAP 


F8 


D1 (L1,B1) ,D2 (L2,B2) 




S1 (L1) ,S2(L2) or j 
S1,S2 | 






Figure 17. Machine Instruction Summary (Part 10 of 14) 
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j Instruction 


Type of |- 


l „_ _. 


Instruction J 
„___ __ i 


|No Operation 


RR , Ext . Mnemonic j 


|0r Logical 


RX j 


|0r Logical 


SS | 


|0r Logical 


RR | 


jor Logical Immediate 


SI | 


J Pack 


SS j 


JRead Direct 


SI | 


|Set Clock 


SI j 


|Set Program Mask 


RR | 


(Set Storage Key 


RR J 


JSet System Mask 


SI | 


j Shi ft and Round 




j Decimal 


SS | 


| Shift Left Double 




| Algebraic 


RS | 


| Shift Left Double 




| Logical 


RS | 


| Shift Left Single 




| Algebraic 


RS | 


| Shift Left Single 




j Logical 


RS | 


| Shi ft Right Double 




j Algebraic 


RS | 


| Shift Right Double 




J Logical 


RS j 


| Shift Right Single 




j Algebraic 


RS | 


j Shift Right Single 




J Logical 


RS | 


j Start I/O 


SI j 


| Start I/O Fast 




| Release 


SI | 


j Store 


RX | 


(Store Channel ID 


SI | 


j Store Character 


RX j 


j Store Character 




J under Mask 


RS \ 


j Store Clock 


SI | 


J Store Control 


RS | 


| Store CPU ID 


SI j 


j Store Half word 


RX | 


j Store Long 


RX, Floating Pt. j 


| Store Multiple 


RS j 


j Store Short 


RX, Floating Pt. j 


j Subtract 


RX | 


j Subtract 


RR | 


j j Subtract Decimal 


SS, Decimal J 


j Subtract Half word 


RX J 


j Subtract Logical 


RX | 


j Subtract Logical 


RR j 



Program Interruptions 
Possible 



Condition Code Set 



-T-T T~T T T T T" 

AJSjOvjPJOpjOther j 00 j 01 | 10 { 11 
~M~ •+-+—+ i~ 4 i — + 









N 


N | 


N j 


j xj 






J 


K | 






x| 




J 
J 


K | 






xj 




J 


K | 






x| 




N 


N 


N | 




xjx 


A 


N 


N | 


N | 


jxj 


xjx 


A 


AAE 


AAF | 










RR 


RR | 


RR | 


| xj 


j x 


A 


N 


N | 


N | 






A 


N 


N | 


N j 


I IE 


xj 


Data 


J 


L | 


M | 


|x|F 






J 


L | 


M | 


I x l 






N 


N | 


N | 


I IF 






J 


L j 


M | 








N 


N | 


N | 


I x l 






J 


L | 


M | 


I x l 






N 


N | 


N | 








J 


L | 


M J 








N 


N | 


N | 






A 


MM 


CC | 


EE j 






A 


MM 


CC | 


EE | 


j xj 


xj 




N 


N | 


N j 




jx 


A 


AAH 


CC j 


AAI j 




x| 




N 


N | 


N I 




xj 




N 


N | 


N | 




xjx 




AAJ 


AAK | 




I x l 


xj 


A 


N 


N 


N | 


I x l 


xjx 


A 


N 


N | 


N j 


I x l 


xj 




N 


N | 


N | 


I x l 


xjx 




N 


N ] 


N | 


jxj 


xj 




N 


N | 


N | 


jxj 


xjx 




N 


N 


N j 


jxjF 






V 


x I 


Y I 


i if 






V 


X | 


Y I 


I ID 


xjx 


Dc.ta 


V 


x 


Y I 


JxjF 






V 


x 


Y I 


jxj 








W,H 
W,H 


v,i I 



-i._J._X X-X- 
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o 



Instruction 



Subtract Normalized, 

Extended 

Subtract Normalized, 

Long 

Subtract Normalized, 

Long 

Subtract Normalized, 

Short 

Subtract Normalized, 

Short 

Subtract 

Unnormalized ,Long 



Subtract 

Unnormalized ,Long 
Subtract 

Unnormalized , Short 
Subtract 

Unnormalized , Short 
Supervisor Call 
Test and Set 

Test Channel 

Test I/O 

Test Under Mask 

Translate 

Translate and Test 

Unpack 

Write Direct 
| Zero and Add Decimal 

i 



Type of 
Instruction 



I— T-'T T-T T T T T — T 

A|S|0v|PJ0p|0ther | 00 | 01 | 10 | 11 

HH—+-4— + 4— — + +" + 



RR, Floating Pt. 
RX, Floating Pt. 
RR, Floating Pt. 
RX, Floating Pt. 
RR, Floating Pt. 
RX, Floating Pt. 

RR, Floating Pt. 

RX, Floating Pt. 

RR, Floating Pt. 

RR 

SI 

SI 
SI 
SI 
SS 
SS 

SS 
SI 
SS, Decimal 



Program Instructions 
Possible 



Condition Code Set 



jx|E 




X 


B,C | 


jxj E 




X 


B,C | 


jxjE 




X 


B,C | 


|x|E 
|x|E 




X 
X 


B,C | 
B,C | 


|x|E 




X 


c I 


|x|E 




X 


c I 


|x|E 




X 


c I 


| x|E 


X 
X 


X 


A | 


I l D 


X 

x 


X 

x 


A | 
Data | 



X 
X 
X 

X 
X 
X 

-J._i._i. x_x. 



R 

R 
N 
SS 

JJ 

LL 

UU 

N 

PP 

N 
N 
J 



|L 


M | 


|L 


M | 


|L 


M | 


|L 


M | 


|L 


M | 


|L 


M | 


|L 


M | 


|L 


M | 


|L 


M J 


|N 


N | 


|TT 




|H 


FF | 


|CC 


EE | 


|W 




|N 


N | 


|NN 


00 | 


|N 


N | 


|N 


N | 


|L 


M | 
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Program Interruptions Possible 



o 



Under Ov: 



Under Other: 



D=Decimal 
E=Exponent 
F=Fixed Point 



A Privileged Operation 
B Exponent Underflow 
C Significance 
D Decimal Divide 
E Floating Point Divide 
F Fixed Point Divide 
G Execute 
GA Monitoring 

Condition Code Set 
H No Carry 

I Carry 

J Result=0 

K Result is Not Equal to Zero 

L Result is Less Than Zero 

M Result is Greater Than Zero 

N Not Changed 

Overflow 

P Result Exponent Underflows 

Q Result Exponent Overflows 

R Result Fraction=0 

S Result Field Equals Zero 

T Result Field is Less Than Zero 

U Result Field is Greater Than Zero 

V Difference=0 

W Difference is Not Equal to Zero 
X Difference is Less Than Zero 

Y Difference is Greater Than Zero 

Z First Operand Equals Second Operand 

AA First Operand is Less Than Second Operand 

BB First Operand is Greater Than Second Operand 

CC CSW Stored 

DD Channel and Subchannel not Working 

EE Channel or Subchannel Busy 

FF Channel Operating in Burst Mode 

GG Burst Operation Terminated 

HH Channel Not Operational 

II Interruption Pending in Channel 
JJ Channel Available 

KK Not Operational 

LL Available 

MM I/O Operation Initiated and Channel Proceeding With its Execution 

NN Nonzero Function Byte Found Before the First Operand Field is Exhausted 

00 Last Function Byte is Nonzero 

PP All Function Bytes Are Zero 

QQ Set According to Bits 34 and 35 of the New PSW Loaded 

RR Set According to Bits 2 and 3 of the Register Specified by R1 

SS Leftmost Bit of Byte Specified=0 

TT Leftmost Bit of Byte Specif ied=1 

UU Selected Bits Are All Zeros; Mask is All Zeros 

W Selected Bits Are Mixed (zeros and ones) 

WW Selected Bits Are All Ones 



(i J 



Figure 17. Machine Instruction Summary (Part 13 of 14) 
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Condition Code Set 



XX Selected Bytes are Equal, or Mask is Zero 

YY Selected Field of First Operand is Low 

ZZ Selected Field of First Operand is High 

AAA First-operand and Second -ope rand Counts are Equal 

AAB First Operand Count is Lower 

AA.C First Operand Count is Higher 

AAD No Movement Because of Destructive Overlap 

AAE Clock Value Set 

AAF Clock Value Secure 

AA.G Clock not Operational 

AAH Channel ID Correctly Stored 

AAI Channel Activity Prohibited During ID 

AAJ Clock Value is Valid 

AAK Clock Value Not Necessarily Valid 

AAL Channel Working With Another Device 



Figure 16. Machine Instruction Summary (Part 14 of 14) 
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Appendix E. Assembler Instructions 



O 



Operation 
Entry 



Name Entry 



Operand Entry 



ACTR 

AGO 

AIF 



Not used , must not be present 



An arithmetic SETA expresssion 



A sequence symbol or not present 



A sequence symbol 



A sequence symbol or not present 



A logical expression enclosed in 
parentheses, immediately followed by a 
sequence symbol 



ANOP 

CCW 

CNOP 



A sequence symbol 



Not used, must not be present 



Any symbol or not present 



Four operands, separated by commas 



A sequence symbol or not present 



Two absolute expressions, separated by a 
comma 



COM 



A sequence symbol or not present 



Not used, should not be present 



COPY 
CSECT 



Not used, must not be present 



A symbol 



Any symbol or not present 



Not used, should not be present 



DC 



Any symbol or not present 



One operand 



DROP 



A sequence symbol or not present 



One to sixteen absolute expressions, 
separated by commas 



DS 



Any symbol or not present 



One operand 



DSECT 



A variable symbol or an 
ordinary symbol 



Not used, should not be present 



EJECT 



A sequence symbol or not present 



Not used, should not be present 



END 



A sequence symbol or not present 



A relocatable expression 
or not present 



ENTRY 



A sequence symbol or not present 



One or more relocatable symbols , 
separated by commas 



EQU 



A variable symbol or an 
ordinary symbol 



An absolute or relocatable expression 



EXTRN 



A sequence symbol or not present 



One or more relocatable symbols, 
separated by commas 



GBLA 



Not used, must not be present 



One or more variable symbols that are to 
be used as SET symbols, separated by 
commas 1 



GBLB 



Not used, must not be present 



One or more variable symbols that are to 
be used as SET symbols, separated by 
commas 1 



I- 

| SET symbols may be defined as subscripted SET symbols. 



(Part 1 of 3) 
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o 



Operation 
Entry 



GBLC 



ICTL 



ISEQ 



LCLA 



LCLB 



LCLC 



MACRO- 



LTORG 



MEND 2 



MEXIT 2 



MNOTE : 



ORG 



PRINT 



PUNCH 



REPRO 



SETA 
SETB 



SETC 



SPACE 



START 



Name Entry 

Not used, must not be present 



Not used, must not be present 



Not used, must not be present 



Not used, must not be present 



Not used, must not be present 



Not used, must not be present 



Any symbol or not present 



Not used, must not be present 



A sequence symbol or not present 



A sequence symbol or not present 



A sequence symbol, a variable 
symbol or not present 



A sequence symbol or not used 



A sequence symbol or not present 



A sequence symbol or not present 



A sequence symbol or not used 



SETA symbol 



A SETB symbol 



A SETC symbol 



A sequence symbol or not present 



Any symbol or not present 



Operand Entry 



One or more variable symbols that are to 
be used as SET symbols, separated by 



commas 



One to three decimal values, separated by 
commas 



Two decimal values, separated by a comma 



One or more variable symbols that are to 
be used as SET symbols, separated by 
commas 1 



One or more variable symbols that are to 
be used as SET symbols, separated by 
commas 1 



One or more variable symbols separated by 
commas 1 



Not used, should not be present 



Not used, should not be present 



Not used, must not be present 



Not used, must not be present 



———————————————— —t-—— ————.— «————•>»— ——— 

A severity code, followed by a comma, 
followed by any combination of characters 
enclosed in apostrophes 



A relocatable expression or not used 



One to three operands 



One to 80 characters enclosed in 
apostrophes 



Not used, must not be present 



An arithmetic expression 



A or a 1 , or logical expression 
enclosed in parentheses 



A type attribute, a character expression, 
a substring notation, or a concatenation 
of character expressions and substring 
notations 



A decimal self-defining term or not used 



A self-defining term or not used 



1 SET 

2 May 



symbols, may be defined as subscripted SET symbols, 
only be used as part of a macro definition. 



(Part 2 of 3) 
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j Operation 
(Entry 

h 



JName Entry 



| TITLE 3 JA special symbol (0 to 4 charac- 
I j ters) , a sequence symbol, a 

| variable symbol, or not present 
+„. 



f— — 

! USING 



J A sequence symbol or not present 



I- 



I WXTRN 4 * 



JA sequence symbol or not present 



Operand Entry 



One to 100 characters, enclosed in 
apostrophes 



An absolute or relocatable expression 
followed by 1 to 16 absolute expressions, 
separated by commas 



|. j. 

| 3 See Section 5 for the description of the name entry. 
|» DOS Assembler 14K D only. 

i ,„===.»«,«.,« 



One or more relocatable symbols 
separated by commas 



ASSEMBLER STATEMENTS 



(Part 3 of 3) 



o 



J 



INSTRUCTION 



NAME ENTRY 



h 



j OPERAND ENTRY 



Model Statements 1 2 
(A variable symbol or any 
assembler language mnemonic 
operation code except COPY, 
END, ICTL, ISEQ, and PRINT) 



Prototype Statement 3 



Macro Instruction 
Statement 3 



Assembler Language 
Statement" 2 



An ordinary symbol, variable 
symbol , sequence 
symbol, a combination of 
variable symbols and other 
characters that is equivalent 
to a symbol, or not used 



A symbolic parameter or 
not used 



An ordinary symbol, a 
variable symbol, a sequence 
symbol , a combination of 
variable symbols and other 
characters that is equivalent 
to a symbol, *» or not used 



An ordinary symbol, a var- 
iable symbol, a sequence 
symbol, a combination 
of variable symbols and 
other characters that is 
equivalent to a symbol, 
or not used 



Any combination of characters 
(including variable 
symbols) 



Zero or more operands that 
are symbolic parameters, 
separated by commas, followed 
by zero or more operands 
(separated by commas) of the 
form symbolic parameter, 
equal sign, optional standard 
value 



Zero or more positional 
operands separated by commas , 
followed by zero or more 
keyword operands (separated 
by commas) of the form 
keyword, equal sign, value** 



Any combination of characters 
(including variable symbols) 



Variable symbols may not be used to generate the following mnemonic operation codes: 

ACTR, COPY, END, ICTL, CSECT, DSECT, ISEQ, PRINT, REPRO, and START. Variable symbols 

may not be used in the name and operand entries of the following instructions: COPY, 

END, ICTL, and ISEQ. Variable symbols may not be used in the name entry of the ACTR 

instruction. 

The line following a REPRO statement may not contain variable symbols. 

May only be used as part of a macro definition. 

Variable symbols appearing in a macro instruction are replaced by their values before 

the macro instruction is processed. 



o 
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Appendix F. Summary of Constants 



1 T 

LENGTH 
MODI- 
FIER 
RANGE 



T 1 

TRUN- 
CATION/ 
PADDING 
SIDE 



TYPE 

AND 

DELIM. 



IMPLIED 
LENGTH 
(BYTES) 



ALIGN- 
MENT 



SPECIFIED 
BY 



CON- 
STANTS 
PER 
OPERAND 



RANGE 
FOR EX- 
PONENTS 



RANGE 

FOR 

SCALE 



as 

needed 



byte 



1 to 
256« 



characters 



one 



right 



H 



X * 



as 
needed 



byte 



1 to 
256 1 



hexadecimal 
digits 



one 



left 



B ' 



as 

needed 



byte 



1 to 
256 



binary 
digits 



one 



left 



j. 

H ' 






word 

half 
word 



1 to 8 j decimal 
digits 

I 1 to 8 | decimal 
digits 



multiple 

+— 

multiple 



-85 to 
♦ 75 
i 

-85 to 
♦75 



-187 to 
+ 346 

4 

-187 to 

+ 346 



left 
left 



+ -H 



E ' 

j. 

D ' 



word 



double 
word 



1 to 8 
1 to 8 



decimal 
digits 






decimal 
digits 



multiple 

+ 

multiple 



-85 to 
+75 
4 

-85 to 
+ 75 



to 14 

4 

to 14 



right 
right 






F 

p ' 



16 

as 
needed 



double 
word 



1 to 
16 



decimal 
digits 






byte 



1 to 
16 



decimal 
digits 



multiple 

+ 

multiple 



-85 to 
+ 75 
4 



to 28 
4 



right 
left 



4 1 



Z ' 



as 
needed 



byte 



1 to 
16 



decimal 
digits 



multiple 



left 
left 



A ( ) 



word 



1 to 4 



an absolute 
expression 



multiple 



V ( ) 



word 



3 or 4 |a relocatable 
or complex 
relocatable 
expression 



3 or 4 



relocatable 
symbol 



multiple 






left 



S ( ) 



half 
word 



2 only 



one absolute 
or relocatab- 
le expression 
or two abso- 
lute expres- 
sions: 
exp (exp) 



multiple 



• In a DS assembler instruction, C and X type constants may have length specification 

to 65535. 
2 DOS Assembler D, 14K variant only. 

(Part 1 of 2) 
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(TYPE 

JAND 

IDELIM, 

!■ H 

IY ( ) 






IMPLIED | I 
LENGTH j ALIGN- J 
(BYTES) j MENT j 

2 | half | 
j word j 
I i- 



LENGTH 
MODI- 
FIER 
RANGE 



1 or 2 



2 only 



SPECIFIED 
BY 



an absolute 
expression 



a relocatable 
or complex 
relocatable 
expression 



CON- 
STANTS 
PER 
OPERAND 



multiple 



RANGE 
FOR EX- 
PONENTS 



RANGE 

FOR 

SCALE 



TRUN- 
CATION/ 
PADDING 
SIDE 



o 



left 
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Appendix G. Macro Facility Summary 



The four charts in this appendix summarize 
the macro facility described in Part 2 of 
this publication. 

Figure 18 indicates which macro facility 
elements may be used in the name and 
operand entries of each statement. 

Figure 19 is a summary of the 
expressions that may be used in macro 
instruction statements. 



Figure 20 is a summary of the attributes 
that may be used in each expression. 



Figure 21 is a summary of the variable 
symbols that may be used in each 
expression. 
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MACRO 
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GBLC 








Operand 
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LCLC 
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Operation 

Operand 


Name 

Operotion 

Operand 


Name 

Operation 

Operand 


Name 

Operotion 

Operond 


Name 

Operation 

Operand 


Operation 
Operond 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Operotion 
Operand 


Name 

Operation 

Operand 














.Name 


COPY 


































Name 


SETA 


Operand^ 


Name 
Operand 


Operand 


Operand 9 


Operand 


Operand 3 


Operand 9 


Operand 




Operand 2 




Operand 


Operand 


Operand 


Operand 


Operond 




SETB 


Operand 6 


Operand" 


Name 
Operand 


Operand 6 


Operand 6 


Operond 


Operand 6 


Operand 6 


Operand 4 


Operand 6 


Operand 4 


Operand 5 


Operand 5 


Operand 5 


Operand 


Operand 5 




SETC 


Operand 


Operand 7 


Operand 8 


Name 
Operand 


Operand 


Operand 8 


Name 
Operand 


Operand 


Operand 


Operand 


Operond 














AIF 


Operand* 


Operand 6 


Operand 


Operand 6 


Operand 6 


Operand 


Operand 6 


Operand 


Operand 4 


Operand 6 


Operand 4 


Operand 5 


Operand 5 


Operand 5 


Operand 5 


Operand 5 


Name 
Operand 


AGO 


































Operand 


ACTR 


Operand 2 


Operand 


Operand 3 


Operand 


Operand 


Operand 3 


Operand 2 


Operand 




Operand 




Operand 


Operond 


Operand 


Operand 


Operand 




ANOP 


































Name 


MEXIT 


































Name 


MNOTE 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 














Name 


MEND 


































Name 


Outer 
Macro 




Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 




















Name 


Inner 
Macro 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 














Name 


Assembler 
Language 
Statement 




Name 

Operotion 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 
Operand 




















Name 


1 . Variable symbols in macro-instructions are replaced by their values before processing. 

2. Only if value is self-defining term. 

3. Converted to arithmetic *-l or +0. 

4. Only in character relations. 

5. Only in arithmetic relations. 

6. Only in arithmetic or character relations. 

7. Converted to unsigned number . 

8 . Converted to character 1 or . 

9. Only if one to eight decimal digits. 



Figure 18. Macro Facility Elements 
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j Expression (Arithmetic Expressions (Character Expressions j Logical Expressions j 
y f __ — — + — --j. 1 



May 
contain 



Operators 
are 



Range 

of values 



May be 
used in 



H- 



Self-defining terms 
Length, scaling, 
integer, count, and 
number attributes 
SETA and SETB symbols 
SETC symbols whose 
value is 1-8 decimal 
digits 

Symbolic parameters 
if the corresponding 
operand is a self- 
defining term 
SSYSLIST (n) if the 
corresponding operand 
is a self-defining 
term 

SSYSL1ST (n,m) if the 
corresponding operand 
is a self-defining 
term 
SSYSNDX 



+,-,*, and / 
parentheses permitted 



-23< to +2 31 -1 



1. SETA operands 

2. Arithmetic relations 

3. Subscripted SET 
symbols 

4. 6SYSLIST 

5. Substring notation 

6. Sublist notation 

7. SETC operands 

8 . ACTR ope rand s 



1. Any combination of 
characters enclosed 
in apostrophes 

2. Any variable symbol 
enclosed in apos- 
trophes 

3. A concatenation of 
variable symbols and 
other characters 
enclosed in apos- 
trophes 

4. A request for a type 
attribute 



concatenation , w^.th 
period (.) 



through 127 (255 for 
assembler F) characters. 



1. SETC operands 3 

2. Character relations 2 

3. SETA operands'* 



1. SETB symbols 

2. Arithmetic relations 1 

3. Character relations 2 



AND, OR, and NOT 
parentheses permitted 



(false) or 

1 (true) 



1 . SETB operands 

2. AIF operands 



H 



An arithmetic relation consists of two arithmetic expressions related by the 

operators GT, LT, EQ, NE, GE, or Le. 

A character relation consists of two character expressions related by the operator 

GT, LT, EQ, NE, GE , or LE. The type attribute notation and the substring notation 

may also be used in character relations. The maximum length of the character 

expressions that can be compared is 127 (255 for assembler F) characters. If the two 

character expressions are of unequal length, then the shorter one will always compare 

less than the longer. 

Maximum of eight characters will be assigned. 

If one to eight decimal digits. 



\I j/ 



V 






Figure 19. Expressions 
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o 



h 

Scaling 



Attribute 



Type 



Length 



Integer 



Count 



Number 



Notation 



T s 



!'• 



K* 



May be used with: 



Symbols outside 

macro definitions; 

symbolic parameters, 

SSYSLIST (n) , and 

SSYSLIST (n,m) inside macro 

definitions 



Symbols outside 

macro definitions; symbolic 

parameters, SSYSLIST (n) , and 

SSYSLIST (n,m) inside macro 

definitions 



Symbols outside 

macro definitions; symbolic 

parameters, SSYSLIST (n) , and 

SSYSLIST (n,m) inside macro 

definitions 



H,F,G,D,E,K,L,P, 
and Z 



Symbols outside 

macro definitions; symbolic 

parameters, SSYSLIST (n) , and 

SSYSLIST (n,m) inside macro 

definitions 



Symbolic parameters 
corresponding to macro 
instruction operands, SSYSLIST 
(n) , and SSYSLIST (n,m) inside 
macro definitions 



Symbolic parameters, 
SSYSLIST, and SSYSLIST (n) 
inside macro definitions 



May be used only il 
type attribute is : 



(May always be 
used) 



[l» SETC operand 

fields 
2 . Character 
relations 
(SETB) 



Any letter except 
M,N,0,T, and U 



H,F,G,D,E,K,L,P, 
and Z 



Any letter 



Any letter 



May be used in 



Arithmetic 
expressions 



Arithmetic 
expressions 



Arithmetic 
expressions 



Arithmetic 
expressions 



Arithmetic 
expressions 



© 



Figure 20.. Attributes 
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Variable 
symbol 



Symbolic* 
Parameter 



SETA 



SETB 



SETC 



6SYSNDX* 



f- 



gSYSECT* 



6SYSLIST 1 



6SYSLIST (n) 1 
SSYSLIST(n,m) « 



SSYSPARM 



h 



Defined by: 



Prototype 
statement 



LCLA or GBLA 
instruction 



LCLB or GBLB 
instruction 



LCLC or GBLC 
instruction 



The assembler 



The assembler 



The assembler 



The assembler 



The assembler 



Initialized, 
or set to: 



Corresponding 
macro instruction 
operand 



Null character 
value 



Macro instruction 
index 



Control section 
in which macro 
instruction 
appears 



Not applicable 



Cor re sponding 
macro instruction 
operand 



Value specified 
in the OPTION 
job control 
statement 



Value changed 
by: 



(Constant 
throughout 
definition) 



SETA 
instruction 



SETB 
instructions 



SETC 
instruction 



(Constant 
throughout 
definition; 
unique for 
each macro 
instruction) 



(Constant 
throughout 
definition; 
set by CSECT, 
DSECT, and 
START) 



Not applicable 



(Constant 
throughout 
definition) 



(Constant 
throughout 
assembly) 



May be used in: 



1 . Arithmetic expressions 
if operand is self- 
defining term 

2. Character expressions 



1 . Arithmetic expressions 

2. Character expressions 



1 . Arithmetic expressions 

2. Character expressions 

3. Logical expressions 



1 . Arithmetic expressions 
if value is one to 
eight decimal digits 

2. Character expressions 



1. Arithmetic expressions 

2. Character expressions 



Character expressions 



N'&SYSLIST in arithmetic 
expressions 



1 . Arithmetic expressions 
if operand is self- 
defining term 

2. Character expressions 



1 . Arithmetic expression 
if value is one to 
eight decimal digits 

2. Character expressions 



| 1 May only be used in macro definitions. 



o 



v> 7 



Figure 21. Variable Symbols 
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Appendix H. Dictionary and Source Statement Sizes 



Part 1. Dictionaries Used in Macro Generation 

A. Dictionaries at Collection Time 

Two or more dictionaries must be constructed to enable the macro 
generator portion of the assembler to accomplish macro generation and 
conditional assembly: a global dictionary and one or more local 
dictionaries. 

Global Dictionary 

A global dictionary containing macro instruction mnemonics and global 
SET variable names is built for the entire program. Dictionary entries 
are fitted into blocks of fixed size, 256 bytes for Assembler (E) and 
1024 bytes for Assembler (F) 

Each block contains complete entries. If an entry cannot fit into the 
remainder of one block, it is put into the next block and bytes in the 
remainder are not used. The sizes of various kinds of dictionary 
entries are as follows: 



© 



| Macro Mnemonic Operation Code 



I Global SET Variable Name 



Fixed Overhead 



10 bytes plus mnemonic* (Assembler F) 
8 bytes plus mnemonic* (Assembler E) 

6 bytes plus name* (Assembler F) 
8 bytes plus name 11 (Assembler E) 

(A dimensioned global SET variable is 
counted only once) 

8 bytes for first block 

4 bytes for each succeeding block 

5 bytes for last block 



j * One byte is used for each character in the name or mnemonic. 

L .. 



The maximum size of the global dictionary is 64 blocks. In addition, 
the maximum number of distinct global symbols for the Assembler (D) is 
400. (SSYSPARM is counted in the 14K variant.) 






Local Dictionary 

A local dictionary containing ordinary symbols relevant to macro 
generation and conditional assembly, sequence symbols and local SET 
variable names is constructed for the main portion of the program. In 
addition, a local dictionary containing an entry for each local SET 
variable name, sequence symbol and prototype symbolic parameter declared 
within a macro definition is constructed for each different macro 
definition used in the program. Dictionary entries are fitted into 
blocks of fixed size, 256 bytes for Assembler (D) and 1024 bytes for 
Assembler (F) . 

Each block contains complete entries. If an entry cannot fit into the 
remainder of one block, it is put into the next block and bytes in the 
remainder are not used. The sizes of various kinds of dictionary 
entries are as follows: 
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Sequence Symbol Names 



Local SET Variable Names 



Prototype Symbolic Parameters 

Relevant ordinary symbols 
appearing in the main 
portion of the program 

Fixed Overhead 



10 bytes plus name 4 (When defined.) 
10 bytes plus name* (When first 
referenced.) 

6 bytes plus name* (A dimensioned local 
SET variable is counted only once.) 

5 bytes plus name 11 

10 bytes plus name* 



8 bytes for first block (32 bytes if a 
macro local dictionary) 

4 bytes for each succeeding block 

5 bytes for last block 



j "• One byte is used for each character in the name or mnemonic. 

i ,. 



The maximum size for the local dictionary is 64 blocks. 



o 



c 



> 
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B. Dictionaries at Generation Time 



To conserve storage during the actual conditional assembly and macro 
generation, the contents of the Global Dictionary and Local Dictionaries 
are restructured as follows: 



o 



o 



Global Dictionary 








(N=dimension) 


I 


— - — i 

Fixed Overhead 


r — 
4 


bytes plus word alignment 


1 


Macro Mnemonic Operation Code 


3 


bytes 




Global SETA dimensioned 


1 


byte plus 4N 




Global SETA undimensioned 


4 


bytes 




Global SETB dimensioned 


1 


byte plus (N/8) 
[N/8 is rounded to the next 
highest integer] 




Global SETB undimensioned 


1 


byte 




Global SETC dimensioned 


1 


byte plus 9N 




Global SETC undimensioned 

_ _ j 


9 

l 


bytes 


i 


Local Dictionary 






1 


(N=dimension) 


t 


_ _ _ _ — _ -. — — — .j 
Fixed Overhead 


r — 
20 
27 


bytes plus word alignment 
for the' F assembler 
bytes plus word alignment 
for the D assembler 


1 


Sequence Symbols 


5 


bytes (when the size of the 
dictionary (see below) is less than 
3000, only the first 40 symbols will 
require 5 bytes each) 




Local SETA dimensioned 


1 


byte plus 4N 




Local SETA undimensioned 


4 


bytes 




Local SETB dimensioned 


1 


byte plus (N/8) 
[N/8 is rounded to the next 
highest integer] 




Local SETB undimensioned 


1 


byte 




Local SETC dimensioned 


1 


byte plus 9N 




Local SETC undimensioned 


9 


bytes 




Relevant ordinary symbols 
appearing in the main portion 
of the program (see Note) 


5 


bytes 
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Note ; For the D assembler, only those ordinary symbols which appear in 
macro instruction operands are included in this table; for the F 
assembler, all ordinary symbols are included. As a result, the F 
assembler may overflow the Local Dictionary before the D assembler. 

The restructured Global Dictionary and the restructured Local 
Dictionary for the main portion of the program must be resident in main 
storage. 

In addition, if the program contains any macro instructions, main 
storage is required for the largest Local Dictionary of the macro 
definitions being processed. Furthermore, if any macro definitions 
contain inner macro instructions, main storage is required for all the 
restructured Local Dictionaries of all the macros in the nest. 

In addition to those requirements specified above for the Local 
Dictionary of the main portion of the program, each macro definition 
Local Dictionary requires the following for the parameter table: 



j Fixed Overhead 
t 



| 22 bytes 

~L 



Table Entries 








a. Character string 


1 


3 bytes plus L 


1 


b. Hexadecimal, binary, 
decimal, and character 
self-defining values 




7 bytes plus L 




c. Symbol 




9 bytes plus L 




d. Sublist 


J. 


10 bytes plus 2N bytes plus Y 


__ j 


L=Length of entry 

N=Number of entries in sublist 

Y=Total length of table entries 


of a., b., and c. formats 


— .j 



vy 



Each nested macro instruction also requires the following: 

r T : 

J Parameter pointer list j 2 bytes plus 2N 

I I 

| Pointers to list in table | 8 bytes plus word alignment 



|N=the number of operands. 

t . 



The size of the dictionary depends on the partition size and the 
assembler variant used. Maximum dictionary sizes for Assembler (D) 
variants in the smallest possible partitions are as follows (in bytes) 



| DOS Assembler (D) Variant 
j. 

| 10K with tape work files 

I 

| 10K with disk work files 

I 

I 14K 



Partition size | 
I 
I 
+- 



10K 



12K 



2050 | 3100 

I I 

| 1500 | 2400 
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Part 2. Macro Mnemonic Table (D Assembler Only) 

As the source text is scanned, a table of macro mnemonics is constructed. There is 
an entry for each macro used or defined as a programmer macro in the program. The 
entries are made under the premise that every undefined operation is a system macro 
mnemonic. This table is then subsetted to locate and edit system macros from the 
library. 

An entry in this subsetted table consists of 9 bytes. With 10,240 or 14,336 
contiguous bytes of main storage available (see "Machine Features Required") , 
approximately 450 distinct macro mnemonics can be handled. When this table 
overflows, processing continues with only those macros defined at that point. If 
additional storage is available, this table is expanded accordingly. 



Part 3. Source Statement Complexity-Conditional Assembly and Macro Generation 

For any statement except macro prototype or macro instructions, a counter is 
increased by one for each literal occurrence of the following: 

1 . Ordinary Symbol 

a. Name, operation, or operand entry (when the operand count starts, the 
counter is decremented by one) , or 

b. Operand of an EXTRN or WXTRN statement, or 

c. Operand of an attribute operator (I/,!',!', etc.) in a SETA, SETB or SETC 
expression, or 

d. Operand of a machine or assembler instruction (only if in the main portion 
of the program) 

2. Variable Symbol 

3. Sequence Symbol 

Note 1 ; The maximum value the counter may attain is 35 for the D assembler and 50 
for the F assembler. 

Note 2 : This restriction applies to the name and operation entry of a macro 
instruction or prototype taken as a unit. Each macro instruction or prototype 
operand (in sublist, each sublist operand) is also subject to the counter 
restriction. 

Examples of counts: 

1. SB2 SETB (T'NAME EQ'W* OR 'PC'. 'A* EQ'AA') count=3 

2. EXTRN A, B, C, £C count=4 

Part 4. Source Statement Complexity-Assembler Statements 

A « P As sembler 

With 10,240 or 14,336 contiguous bytes of main storage available (see "Machine 
Features Required") , the size of any statement must be less than a certain limit. 
This limit is: 

1 . 727 bytes for DC or DS statements. 

2. 743 bytes for all other statements. 
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There are two formulas used to estimate the size (in bytes) of a statement. 
The greater of the two calculated values (S, or S 2 ) determines whether the 
statement is less than the given limit. In general, all statements can be 
processed if they contain 50 or fewer terms. If a statement contains more than 
50 terms, the formulas should be used to determine if the statement can be 
processed, or if the statement should be shortened using EQU assembler 
instructions. (In the example for S 1r if A+ (B-C) *3 were equated to a symbol, 
that symbol could be used as the displacement field of the first operand.) The 
formulas for statement size, S, and S 2 , follow. 



S, = 



1 = N B + N D+ 4(N LS + N SD ) + 6(N S+ N L ) 

N B = the total number of bytes in name, operation, operand, and comments 
entries. (The maximum value of N B is 187.) 

N D = the number of operators and delimiters in the operand entry [except 
equal (=) , period (.) , and apostrophe (') ] * 

N Lg = the number of references to length attribute (L* SYMBOL) . 



'SD 



the number of self -defining terms. 



N s = the number of symbolic terms (including *) 



the number of literal operands. (The maximum is 1.) 



Example: 



NAME MVC A+ (B-C) *3 (L'D,5) , = 1 5CL 5 • ABCDEFG ■ 
S,=39+9+4 (1 + 4) +6 (3+1) 
=92 bytes 



N 



B + 9(W„ + W 2 +. 



+ W ± + N E ) + N ED 



<f 



N B = the total number of bytes in name, operation, operand, and comments 
entries. (The maximum value of N B is 187) . 



W„ + W 2 +w i+-h a we ig^t associated with the 1st, 2nd, 

,i expression. 

Wi = 1, if the expression is: 

a. absolute, 

b. simply relocatable, or 

c. in error. 

If the expression is complexly relocatable, W^ depends on the number of 
unpaired control section numbers (N £SD ) . 



'ESD 



n 

j 2, 3, 4, OR 5 
| 6, 7, 8, OR 9 
| 10, 11, 12, OR 13 
| 14, 15, OR 16 

I 



= the number of expressions. 



Ned = tne number of expression delimiters. 

The rules for counting the number of expressions (N E ) and the number of 
expression delimiters (Ned) are: 

1. Expression delimiters are commas and the terminating blank of an operand. 
2. Left and right parentheses can be part of an expression or can be 
expression delimiters. A left or right parenthesis is an expression 
delimiter if it ends an expression. Otherwise, it is part of an expression. 
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Example 1 : The operand is: 

5,6,A+20*B(6,7) 

The expression delimiters are the three commas, the left parenthesis [(\ . the 
right parenthesis [) ] , and the terminating blank. 

The first, second, fourth, and fifth expressions all have a weight of 1. The 
third expression in the operand [A+20*B] has a weight of 1 (either B is absolute, 
making the result absolute or simply relocatable or, B is relocatable so the 
expression is in error. 

S 2 = N B + 9 (W x + W 2 + W 3 + W 4 + W 5 + N E ) ♦ N ED 

S 2 = N B + 9 (1 + 1 + 1 ♦ 1 + 1 + 5) +6 

S 2 = N B + 96 bytes 

Example 2 ; The operand is: 

A+17* (OD) , (A+20) 

The number of expressions (N E ) is 2. The first expression is A+17*(X-D) . The 
second expression is (A+20) 

The number of expression delimiters (N ED ) is 2 (the comma and the terminating 
blank) . 

E xample 3 : The operand is: 

20 (,3) ,16 (5) 

There are 5 expressions and 7 expression delimiters. 



Expression 1 = 20 
Expression 2 = 5 
Expression 3 = 3 
Expression U = 16 
Expression 5 = 5 



B. F Assembler 



Expression Delimiter 1 = ( 

Expression Delimiter 2 = , 

Expression Delimiter 3 = ) 

Expression Delimiter 4 = , 

Expression Delimiter 5 = ( 

Expression Delimiter 6 = ) 

Expression Delimiter 7 = blank 



1. Generated statements may not exceed 27 2 characters. Statement length 
includes name, operation, operand, and comments. If a comments field 
exists, the blank separating the operand and the comments field is included 
in the statement length. The statement is truncated if it exceeds 272 
characters. 

2. DC, DS and literal DCs cannot contain more than 32 operands per statement. 



Part 5. Print Control Statement Listing Restrictions 

TITLE, SPACE and EJECT statements will not appear in the source listings unless the 
statement is continued onto another card. Then the first card of the statement will 
be listed. If any of these three statements are generated by macro expansion, they 
will not be listed (regardless of continuation) if the current PRINT option is NOGEN. 
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Appendix I. Sample Program and Assembler Listing Description 



The assembler listing consists of five 
sections, ordered as follows: external 
symbol dictionary items; the source and 
object program statements; relocation 
dictionary items; symbol cross-reference 
table; and diagnostic messages. 



The following sample program illustrates 
an actual assembler listing. Several 
errors have been included to show their 
effect on an assembly. 



Given : 

1. A. TABLE with 15 entries, each 16 bytes long, having the following format: 

r 1 t t ■ 1 

j NUMBER of items | SWITCHes | ADDRESS | NAME | 

L J. L „ JL J 

3 bytes 1 byte 4 bytes 8 bytes 

2. A LIST of items, each 16 bytes long, having the following format: 

r 1 t ■ t 1 

j NAME | SWITCHes | NUMBER of items j ADDRESS | 

L J. J -L J 

8 bytes 1 byte 3 bytes 4 bytes 

Find: Any of the items in the LIST which occur in the TABLE and put the SWITCHes, 
NUMBER of items, and ADDRESS from that LIST entry into the corresponding TABLE entry. 
If the LIST item does not occur in the TABLE, turn on the first bit in the SWITCHes byte 
of the LIST entry. 

The TABLE entries have been sorted by their NAME. 
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EXTERNAL 


SYMBOL 


DICTIONARY 


PAGE I 


SYMBOL 


TYPE ID 
PC 01 


ADDR 
000000 


LENGTH 
0001C0 


LO ID 










SEARCH 


LO 


000026 




01 











if 



EXTERNAL SYMBOL DICTIONARY (ESP) 

This section of the listing contains the 
external symbol dictionary information 
passed to the linkage editor in the object 
module. The entries describe the control 
sections, external references, and entry 
points in the assembled program. There are 
five types of entries, shown along with 
with their associated fields. The circled 
numbers refer to the corresponding heading 
in the sample listing. 



This column contains symbols that 
appear in the name field of CSECT or 
START statements, as operands of 
ENTRY, EXTRN, and WXTRN statements, or 
in the operand field of V-type address 

This column contains the type 
designator for the entry, as shown in 
the table. The type designators are 
defined as: 
SD — names section definition. The 

symbol appeared in the name field 
of a CSECT or START statement. 



LD — The symbol appeared as the 

operand of an ENTRY statement 



l + f f f f 

SD 

LD 



SYMBOL 



r— r-t 



2 

TYPE 



ER 



PC 



CM 



wx 



3 

ID 



X 



ADDR 



5 

LENGTH 



6 

LDID 
.j 

j, 

X 



The X indicates entries accompanying 
each type designation. 



ER — external reference. The symbol 
appeared as the operand of an 
EXTRN statement, or was defined 
as a V-type address constant. 

PC — unnamed control section 
definition. 

CM — common control section 
definition. 

WX — weak external reference. The 

symbol appeared as the operand of 
a WXTRN statement. 

This column contains the external 
symbol dictionary identification 
number (ID) . The number is a unique 
two digit hexadecimal number 
identifying the entry. It is used by 
the LD entry of the ESD and by the 
relocation dictionary to cross 
reference to the ESD. 
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© 


EXAM 


SAMPLE PROGRAM 












PAGE I 


© 


© © 


© 




© 




© 


© 


LOC 


OBJECT COOE ADDR1 ADDR2 


STMT 


SOURCE STATEMENT 




DOS CL3-0 


09/16/67 






2 


••••••••••••••••••••••••••••••••••••••••••••••••••••••it**************** 


SAMPlOOl 






3 

4 
5 


• 


THIS IS THE MACRO DEFINITION 




• 


SAMHL002 
SAyPL003 
SAMPL0O4 








MACRO 










6 




MOVE £T0, tFROM 






SAMPLOlli 






7 


.* 








S AMP L 006 






8 


.» 


DEFINE SETC SYMBOL 






SAMPL00 7 






9 


.» 








SAMPLOOi) 






10 




LCLC {.TYPE 






SAMPLOO'J 






11 


.» 








SAMPL010 






12 


. • 


CHECK NUMBER OF OPERANOS 






SAMPLOll 






13 


.» 








SAMPL012 






14 




AIF (N'tSYSLIST NE 2).tRR0Rl 






SAMPL013 






15 


. • 








SAMPL014 






16 


.# 


CHECK TYPE ATTRIBUTES OF OPERANDS 






SAMPLOll 






17 


. » 








S&MPL0I6 






18 




AIF (T'tTO NE !• tFROM) .ERR0R2 






SAMPL017 






19 




AIF (T'STO EQ 'C OR T'tTO EQ 'G' OR T'tTO EO 


K« ) 


.TYPECGK 


SAMPLOltf 






20 




AIF (T'tTO EO 'D' OR T'tTO EQ «E» OR T'tTO EQ 


H' ) 


•TYPEDEH 


SAMPL019 






21 




AIF (T'tTO EQ «F').MOVE 






SAMPL020 






22 




AGO .ERR0R3 






SAMPL021 






23 


.TYPEDEH ANOP 






SAMPLO?^ 






24 


, » 








SAMPL02 3 






25 


.* 


ASSIGN TYPE ATTRIBUTE TO SETC SYMBOL 






SAMPL0?4 






26 


.« 








SAMP1.025 






27 


tTYPE 


SETC T'CTO 






SA.VHL026 






28 


.MOVE 


ANOP 






SANPL02/ 






29 


• 


NEXT TWO STATEMENTS GENERATED FOR MOVE MACRO 






SAMPL02H 






30 




LtTYPfc 2, tFROM 






SAMPL029 






31 




STtTYPE 2,tT0 






SAMPL030 






32 




MEXIT 






SAMPL031 






33 


• * 








SAMPL0J2 






34 


• • 


CHECK LENGTH ATTRIBUTES OF OPERANDS 






SAMPL033 






35 


. • 








SAMPL0J4 






36 


TYPECGK 


AIF (L'tTO NE L'tFROM OR L'tTO GT 256).ERR0R4 






SAMPLOJs 




•»* ERROR •»• 


















37 


• 


NEXT STATEMENT GENERATED FOR MOVE MACRO 






SAMPL036 






38 




MVC tTO, tFROM 






SAMPL037 






39 




MEXIT 






SAMPL0J8 






40 


• * 








SAMPL039 






41 


.« 


ERROR MESSAGES FOR INVALID MOVE MACRO INSTRUCTIONS 




SAMPL040 






42 


. • 








SAMPL041 






43 


.ERR0R1 


MNOTE It 'IMPROPER NUMBER OF OPERANDS, NO STATEMENTS 


GENERATED' 


SAMPL042 






44 




MEXIT 






SA^PL043 






45 


.ERR0R2 


MNOTE 1, 'OPERAND TYPES DIFFERENT, NO STATEMENTS 


GENERATED' 


SAMPL044 






46 




MEXIT 






SAMPL041> 






47 


.ERR0R3 


MNOTE 1,' IMPROPER OPERAND TYPES, NO STATEMENTS GENERATED' 


SAMHL046 






48 




MEXIT 






SAMHL047 






49 


•ERR0R4 


MNOTE I, 'IMPROPER OPERAND LENGTHS, NO STATEMENTS 


GENERATED' 


SAMPL048 






50 




MEND 






SAMPL049 



The column contains the address of the 
symbol (hexadecimal notation) for SD 
and LD type entries, and zeros for ER 
and WX type entries. For PC and CM 
type entries, it indicates the 
beginning address of the control 
section. 



This column contains the assembled 
length, in bytes, of the control 
section (hexadecimal notation) . 



This column contains, for LD type 
entries, the identification (ID) 
number assigned to the ESD entry that 
identifies the control section in 
which the symbol was defined. 



SOURCE AND OBJECT PROGRAM 



This section of the listing documents the 
source statements and the resulting object 
program. 



This is the deck identification. It 
is the symbol that appears in the name 
field of the first TITLE statement. 



This is the information taken from the 
operand field of a TITLE statement. 



Listing page number. 

This column contains the assembled 
address (hexadecimal notation) of the 
object code. 
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© 


EXAM 




SAMPLE 


PROGRAM 














PAGE 2 


® 




© 




© 


© 




© 




© 


© 


LOC 


OBJECT CODE 




AD0R1 


ADDR2 


STMT 

52 
53 
54 
55 


SOURCE STATEMENT 


DOS CL3-0 


09/l£/67 

SAMPL050 
SAMPL051 
SAMPL052 
SAMPL053 














• 


MAIN 


ROUTINE 


• 


000000 














CSECT 


















56 




ENTRY 


SEARCH 




SAMPL054 


000000 


05C0 










57 


BEGIN 


BALR 


R12,0 


ESTABLISH ADDRESSABILITY OF PROGRAM 


SAMPL055 


000002 












58 




USING 


•,R12 


AND TELL THE ASSEMBLER 


SAMPL056 


000002 


9857 


C1A6 






001A8 


59 




LM 


R5,R7,=A(LISTAREA,16,LISTEND> LOAD LIST AREA PARAMS 


SAMPL05/ 


000000 












60 




USING 


LIST.R5 


REGISTER 5 POINTS TO THE LIST 


SAMPL058 


000006 


45E0 


C024 






00026 


61 


MORE 


BAL 


R 14 t SEARCH 


FIND LIST ENTRY IN TABLE 


SAMPL059 


OOOOOA 


9180 


C022 




00024 




62 




TM 


SWITCH, NONE 


CHECK TO SEE IF NAME WAS FOUND 


SAMPL060 


OOOOOE 


4710 


C018 






0001A 


63 




BO 


NOTTHERE 


BRANCH IF NOT 


SAMPL06L 


000000 












64 
65 




USING 
MOVE 


TABLE, Rl 
TSWITCH.LSWITCH 


REGISTER 1 NOW POINTS TO TABLE ENTRY 
MOVE FUNCTIONS 


SAM PL 06 2 
SAMPL063 




••* ERROR 


• •» 




























66 






I, IMPROPER OPERAND 


TYPES, NO STATEMENTS GENERATED 
















67 




MOUE 


TNUMBER.LNUMBER 


FROM LIST ENTRY 






••• ERROR 


• • 


• 




























68 




MOVE 


TADDRESS.LADDRESS 


TO TABLE ENTRY 


SAMPL069 














69* 


• 


NEXT 


TWO STATEMENTS GENEKATED FOR MOVE MACRO 




000012 


5820 


500C 






OOOOC 


70* 




L 


2.LADDRESS 






000016 


5020 


1004 






00004 


71* 




ST 


2,TAD0RESS 






00001A 


9680 


5008 




00008 




72 


NOTTHERE 01 


L SWITCH, NONE 


TURN ON SWITCH IN LIST ENTRY 


SAKPLO/S 


00001E 


8756 


C004 






00006 


73 

74 




BXLE 
EOJ 


R5,R6,M0RE 


LOOP THROUGH THE LIST 

END OF PROGRAM, USER LIBRARY MACRO 


SAMPL076 
SAMPL077 














75-» 


• 360N- 


-CL-453 


EOJ CHANGE LEVEL 3-0 




000022 


OAOE 










76* 




SVC 


14 






000024 












77 


SWITCH 


DS 


X 




SAMPL078 


000080 












78 
79 
80 
81 


NONE 


EQU 


X«80« 




SAMPL079 
SAMPL080 
SAMPL081 
SAHPL032 














• 


BINARY SEARCH ROUTINE 


• 


000025 


00 


















000026 


947F 


C022 




00024 




82 


SEARCH 


NI 


SWITCH, 255-NONE 


TURN OFF NOT FOUND SWITCH 


SAMPL083 


00002A 


9813 


CIB2 






001B4 


83 




LM 


Rl,R3,=F«128,4,128 


LOAD TABLE PARAMETERS 


SAMPL0d4 


00002E 


4111 


C046 






00048 


84 




LA 


RliTABLARfcA-16(Rl) 


GET ADDRESS OF MIDDLE ENTRY 


SAMPL035 


000032 


8830 


0001 






00001 


85 


LOOP 


SRL 


R3,l 


DIVIDE INCREMENT BY 2 


SAMPL086 


000036 


D507 


5000 1008 


00000 


00008 


86 




CLC 


LNAME.TNAME 


COMPARE LIST ENTRY WITH TABLE ENTRY 


SAMPL087 


00003C 


4720 


C04A 






0004C 


87 




BH 


HIGHER 


BRANCH IF SHOULD BE HIGHER IN TABLE 


SAMPL088 


0000*0 


078E 










88 
89 




8CR 
SR 


8,R14 
R1.R3 


EXIT IF FOUND 

OTHERWISE IT IS LOWER IN THE TABLE 


SAMPL009 
XSAMPL090 


000042 


1813 


















SO SUBTRACT INCREMENT 


SAMPL091 


000044 


4620 


C030 






00032 


90 


MORE 


BCT 


R2,L00P 


LOOP 4 TIMES 


SAMPL092 




*»• ERROR 


• •• 
















000048 


47F0 


C050 






00052 


91 




B 


NOTFOUNO 


ARGUMENT IS NOT IN THE TABLE 


SAMPL09J 


00004C 


1A13 










92 


HIGHER 


AR 


R1,R3 


ADD INCREMENT 


SAMPL094 


00004E 


4620 


C030 






00032 


93 




BCT 


R2,L00P 


LOOP 4 TIMES 


SAMPL095 


000052 


9680 


C022 




00024 




94 


NOTFOUND 01 


SWITCH, NONE 


TURN ON NOT FOUND SWITCH 


SAMPL096 


000056 


07FE 










95 




BR 


R14 


EXIT 


SAMPL097 



This column contains the object code 
produced by the source statement. The 
entries are always left- justified. 
The notation is hexadecimal. Entries 
are machine instructions or assembled 
constants. Machine instructions are 
printed in full with a blank inserted 
after every four digits (two bytes) . 
Constants may be only partially 
printed (see the PRINT assembler 
instruction in "Assembler Instruction 
Statements") . 



These two columns contain effective 
addresses (the result of adding 
together a base register value and 
displacement value) : 



1. The column headed ADDR1 contains 
the effective address for the 
first operand of an SS or an SI 
instruction. 



2. The column headed ADDR 2 contains 
the effective address of the 
second operand of any instruction 
referencing storage. 



o 



Both address fields contain six 
digits; however, if the high order 
digit is a zero, it is not printed. 
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© 


EXAM 


SAMPLE PROGRAM 
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© 


© ® 


© 




© 




© © 


LOC 


OBJECT CODE A00R1 A00R2 


STMT 


SOURCE 


STATEMENT 


DOS CL3-0 09/ 16/6 f 






97 


• 






SAMPL099 






98 


• 


THIS 


IS THE TABLE 


SAMPL100 






99 


• 






SAMPL101 


000058 




100 




OS 


00 


SAMPL102 


000058 


0000000000000000 


101 


TABLAREA 


OC 


XL8«0« 


SAMPL103 


000060 


C1D3D7C8C1404040 


102 




DC 


CL8"ALPHA« 


SAMPL104 


000068 


0000000000000000 


103 




OC 


XL8«0« 


SAMPL105 


000070 


C2C5E3C140404040 


104 




DC 


CL8'BETA» 


SAMPL106 


000078 


0000000000000000 


105 




DC 


XL8«0« 


SAMPL107 


000080 


C4C5D3E3C 1404040 


106 




DC 


CL8«DELTA« 


SAMPL108 


000088 


0000000000000000 


107 




DC 


XL8»0» 


SAMPL109 


000090 


C5D7E2C903D6D540 


108 




DC 


CL8'EPSIL0N« 


SAMPL110 


000098 


0000000000000000 


109 




OC 


XL8«0» 


SAMPLlll 


OOOOAO 


C5E3C14040404040 


110 




DC 


CL8«ETA» 


SAMPL112 


0000A8 


0000000000000000 


Ul 




DC 


XL8»0» 


SAMPL113 


COOOBO 


C7C1D404C1404040 


112 




DC 


CL8«GAMMA» 


SAMPLU4 


000068 


0000000000000000 


113 




DC 


XL8»0« 


SAMPLUb 


OOOOCO 


C9D6E3C140404040 


114 




OC 


CL8M0TA* 


SAMPLU6 


0000C8 


0000000000000000 


115 




DC 


XL8'0« 


SAMPLIW 


OOOODO 


D2C1D7D7C1404040 


116 




DC 


CL8«KAPPA« 


SAMPLU8 


000008 


0000000000000000 


117 




DC 


XL8«0« 


SAMPL119 


COOOEO 


03C1D4C2C4C14040 


118 




OC 


CL8«LAMBDA» 


S AMP L 120 


0000E8 


0000000000000000 


119 




OC 


XL8«0« 


SAMPL121 


OOOOFO 


D4E4404040404040 


120 




OC 


CL8«MU» 


SAMPL122 


0O0OF8 


0000000000000000 


121 




OC 


XL8»0« 


SAMPL12J 


000100 


051:4404040404040 


122 




DC 


CL8«NU' 


SAMPL124 


000108 


0000000000000000 


123 




DC 


XL8«0« 


SAMPL125 


000110 


D6D4C9C309D6D540 


124 




OC 


CLS'OMICRON' 


SAMPL126 


000118 


F040404040404040 


125 




OC 


CL8«0' 


SAMPH27 


000120 


07C8C 940404 04040 


126 




DC 


CL8»PHI« 


SAMPL128 


000128 


0000000000000000 


127 




DC 


XL8«0« 


SAMPL12'* 


000130 


E2C9C7D4C1404040 


128 




DC 


CL8«SIGMA» 


SAMPL130 


C00138 


0000000000000000 


129 




DC 


XL8«0» 


SAMPL131 


000140 


E9C5E3C140404040 


130 
131 


• 


DC 


CL8«ZETA« 


SAMPL132 
SAMPL133 






132 


• 


THIS 


IS THE LIST 


SAMPL134 






133 


• 






SAMPL135 


000148 


03C104C2C4C14040 


134 


LISTAREA 


DC 


CL8«LAMBDA» 


SAMPL136 


000150 


OA 


135 




DC 


X«0A» 


SAMPL13 7 


000151 


000010 


136 




DC 


FL3«29» 


SAMPL13U 


000154 


00000000 


137 




DC 


A(BEGIN) 


SAMPL139 


000158 


E9C5E3C140404040 


138 




DC 


C18»ZETA» 


SAMPL140 


000160 


05 


139 




OC 


X'05« 


SAMPL141 


000161 


000005 


140 




DC 


FL3«5» 


SAMPL142 


000164 


00000032 


141 




DC 


A (LOOP) 


SAMPL143 


000168 


E3C8C5E3C1404040 


142 




DC 


CLB'THETA* 


SAMPL144 


000170 


02 


143 




DC 


X«02' 


SA^PL14i 


000171 


00002D 


144 




DC 


FL3«45' 


SAMPL146 


000174 


00000000 


145 




DC 


A(BEGIN) 


SAMPL147 


000178 


E3C1E44040404040 


146 




OC 


CL8«TAU« 


SAMPL148 


000180 


00 


147 




DC 


X»00« 


SAMPL149 



o 



This column contains the statement 
number. A plus sign (+) to the right 
of the number indicates that the 
statement was generated as the result 
of macro instruction processing. The 
maximum statement number is 65,535. 
If there are more than 65,535 
statements, the statement number 
wraps -around. 

This column contains the source 
program statement. The following 
items apply to this section of the 
listing: 

a. Source statements are listed, 

including those brought into the 
program by the COPY assembler 



instruction, and macro 
definitions submitted with the 
main program for assembly. 
Listing control instructions are 
not printed, except for the 
following case: PRINT is listed 
when PRINT ON is in effect and a 
PRINT statement is encountered. 



Macro definitions for system 
macro instructions are not 
listed. 

The statements generated as the 
result of a macro instruction 
follow the macro instruction in 
the listing. 



o 
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EXAM 


SAMPLE PROGRAM 
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© 
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© 


© 


© 




© 


© 


LOC 


OBJECT CODE ADDR1 ADDR2 


STMT 


SOURCE 


STATEMENT 


DUS CL3- 


-0 09/16/67 
SAMPL150 


000181 


000000 






148 




DC 


FL3'0» 




000184 


00000001 






149 




DC 


A( 1) 




SAMPL 151 


000188 


D3C9E2E340404040 




150 




DC 


CL8'LIST' 




SAMPL152 


000190 








151 




DC 


X'lG* 




SAMPL 1 53 




»•• ERROR »•• 
















000190 


0001C8 






152 




DC 


FL3'456» 




SAMPL 1*4 


000193 


00 


















000194 


00000000 






153 




DC 


A(0) 




SAMPL155 


000198 


C1D307C8C1404040 




154 


LISTENO 


DC 


CL8»ALPHA' 




SAMPL 1*6 


0001A0 


00 






155 




DC 


X»00' 




SAMPL15/ 


0001A1 


000001 






156 




DC 


FL3'l« 




SAMPL158 


0001A4 


0000007B 






157 
158 


• 


DC 


A( 123) 




SAMPLl*9 
SAMPL160 










159 


• 


THESE 


ARE THE SYMBOLIC REGISTERS 




SAMPL161 










160 


• 








SAMPL 162 


000001 








161 


Ri 


EQU 


1 




SAMPL163 


000002 








162 


R2 


EOU 


2 




SAMPL164 


000003 








163 


R3 


EQU 


3 




SAMPL 163 


000005 








164 


R5 


EQU 


5 




SAMPLlbo 


000006 








165 


R6 


EQU 


6 




SAMPL16/ 


000007 








166 


R7 


EQU 


7 




SAMPL 168 


OOOOOC 








167 


R12 


EQU 


12 




SAMPL169 


OOOOOE 








168 
169 


R14 

• 


EQU 


14 




SAMPL I 70 
SAMPL171 










170 


• 


THIS 


IS THE FORMAT DEFINITION OF LIST ENTRIES 




SAMPI. 1/2 










171 


• 








SAMPL1 /3 


COOOOO 








172 


LIST 


DSECT 






SAMPL 1/4 


000000 








173 


LNAME 


DS 


CL8 




SAMPLl/5 


000008 








174 


LSWITCH 


DS 


C 




SAMPL176 


000009 








175 


LNUMBER 


DS 


FL3 




SAMPL177 


OOOOOC 








176 
177 


LADORESS 

• 


DS 


F 




SAMPL i /a 
SAMPL179 










178. 


• 


THIS 


IS FORMAT DEFINITION OF TABLE ENTRIES 




SAMPL180 










179 


• 








SAMPL 181 


000000 








180 


TABLE 


DSECT 






SAMPL182 


COOOOO 








1B1 


TNUMBER 


DS 


EL3 




SAMPLIB3 


000003 








182 


TSWITCH 


DS 


C 




SAMPL 184 


000004 








183 


TAOORESS 


DS 


F 




SAMPL 18* 


C00008 








184 


TNAME 


DS 


CL8 




SAMPL 186 


COOOOO 








185 




END 


BEGIN 




SAMPL187 


0001A8 


0000014800000010 




186 






=A(LISTAREA,16,LISTEND) 






0001B4 


0000008000000004 




187 






"F'128,4,128* 







© 



d. Assembler or machine instructions 
in the source program that 
contain variable symbols are 
listed twice: as they appear in 
the source input, and with values 
substituted for the variable 
symbols . 

e. Diagnostic messages are not 
listed inline in the source and 
object program section. An error 
indicator, ***ERROR***, appears 
following the statement in error. 
The message appears in the 
diagnostic section of the 
listing. 

f . MNOTE messages are listed inline 
in the source and object program 
section. An MNOTE indicator 
appears in the diagnostic section 
of the listing. The MNOTE 
message format is: severity 
code, message text. 

g. The MNOTE * form of the MNOTE 
statement results in an inline 



l. 



message only. An MNOTE indicator 
does not appear in the diagnostic 
section of the listing. 

When an error is found in a 
programmer macro definition, it 
is treated like any other 
assembly error: the error 
indication appears after the 
statement in error, and a 
diagnostic is placed in the list 
of diagnostics. However, when an 
error is encountered during the 
expansion of a macro instruction 
(system or programmer defined) , 
the error indication appears in 
place of the erroneous statement, 
which is not listed. The error 
indication appears following the 
last statement listed before the 
erroneous statement was 
encountered, and the associated 
diagnostic message is placed in 
the list of diagnostics. 

Literals will appear in the 
listing following an LTORG or the 
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RELOCATION DICTIONARY 



PAGE 



© © ® © 

POS. ID REL.ID FLAGS ADDRESS 



01 


01 


oc 


000154 


01 


01 


oc 


000164 


01 


01 


oc 


000174 


01 


01 


oc 


0001A8 


01 


01 


oc 


0001B0 



END statement or both. Literals 
are identified by the equals (=) 
sign preceding them. 

j. If the END statement contains an 
operand, the transfer address 
appears in the location column 
(LOC) . 

k. In the case of COM, CSECT, and 
DSECT statements, the location 
field contains the beginning 
address of these control sections 
i.e., the first occurrence. 

1. For a USING statement, the 

location field contains the value 
of the first operand. 

m. For LTORG and ORG statements, the 
location field contains the 
location assigned to the literal 
pool or the value of the ORG 
operand. 

n. For an EQU statement the location 
field contains the value 
assigned. 

o. Generated statements always print 
in normal statement format, 
Because of this, it is possible 
for a generated statement to 
occupy two or more continuation 
lines on the listing. This is 
unlike source statements which 
are restricted to one 
continuation line. 



1,5 This field indicates the assembler 
level and version number, e.g., DOS 
CL2-1 reads as DOS assembler level 2, 
version 1. 

' 6 Current date obtained from SET card. 

17 Identification- sequence field from the 
source statement. 



RELOCATION DICTIONARY 

This section of the listing contains the 
relocation dictionary information passed to 
the linkage editor in the object module. 
The entries describe the address constants 
in the assembled program that are affected 
by relocation. 



This column contains the external 
symbol dictionary ID number assigned 
to the ESD entry that describes the 
control section in which the address 
constant is used as an operand. 



This column contains the external 
symbol dictionary ID number assigned 
to the ESD entry that describes the 
control section in which the 
referenced symbol is defined. 



166 



20 The two-digit hexadecimal number in Bits and 1 Bit 2 

this column is interpreted as follows: 00 = 1 byte = ♦ 

01 = 2 bytes 1 = - 

First Digit — a zero indicates that the 10 = 3 bytes 

entry describes an A- type, a Y-type, 11=4 bytes 
or a CO* address constant; 

Second Digit — the first three bits of 2i This column contains the assembled 

this digit indicate the length and address of the field where the address 

sign of the address constant as constant is stored, 
follows : 



i 



o 
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CROSS-REFERENCE 


PAGE I 


© 


© 


® 


© 




® 






SYMBOL 


LEN 


VALUE 


OEFN 










BEGIN 


00002 


000000 


00057 


0137 


0145 


0185 




HIGHER 


00002 


00004C 


00092 


0087 








LADDRESS 


00004 


oooooc 


00176 


0070 








LIST 


00001 


000000 


00172 


0060 








LISTAREA 


00008 


000148 


00134 


0059 


0186 






LISTENO 


00008 


000198 


00154 


0059 


0186 






LNAME 


00008 


000000 


00173 


0086 








LNUMBER 


00003 


000009 


00175 










LOOP 


00004 


000032 


00085 


0090 


0093 


0141 




LSWITCH 


00001 


000008 


00174 


0072 








MORE 


00004 


000006 


00061 


0073 








MORE 


00004 


000006 


00090 










NONE 


00001 


000080 


00078 


0062 


0072 


0082 0094 




NOTFOUND 


00004 


000052 


00094 


0091 








NOTTHERE 


00004 


00001A 


000 72 


0063 








Rl 


00001 


000001 


00161 


0064 


0083 


0084 0084 0089 0092 




R12 


00001 


oooooc 


00167 


0057 


0058 






R14 


00001 


0OOO0E 


00168 


0061 


0088 


Q095 




R2 


00001 


000002 


00162 


0090 


0093 






R3 


00001 


000003 


00163 


008 3 


0085 


0089 0092 




R5 


00001 


000005 


00164 


0059 


0060 


0073 




R6 


00001 


000006 


00165 


0073 








R7 


00001 


000007 


00166 


0059 








SEARCH 


00004 


000026 


00082 


0056 


0061 






SWITCH 


00001 


000024 


00077 


0062 


0082 


0094 




TABLAREA 


00008 


000058 


00101 


0084 








TABLE 


00001 


000000 


00180 


0064 








TAODRESS 


00004 


000004 


00183 


0071 








TNAME 


00008 


000008 


00184 


0086 








TNUMBER 


00003 


000000 


00181 










TSWITCH 


00001 


000003 


00182 











CROSS-REFERENCE 



This section of the listing information 
concerns symbols — where they are defined 
and used in the program. 



This column contains the symbols. 



This column states the length (decimal 
notation) , in bytes, of the field 
occupied by the symbol value. 



This column contains either the 
address the symbol represents, or a 
value to which the symbol is equated 



This column contains the statement 
number of the statement in which the 
symbol was defined. 



This column contains the statement 
numbers of statements in which the 
symbol appears as an operand. 



The following notes apply to the 
cross-referencing section: 



Symbols appearing in V-type address 
constants do not appear in the 
cross-reference listing. 



A PRINT OFF listing control 
instruction does not affect the 
production of the cross-reference 
section of the listing. 



Undefined symbols appear in the 
cross-reference section. However, 
only the symbol column and the 
reference column have entries. 



vV 
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EXAM 






DIAGNOSTICS f 


© 


® 


® 




STMT 


ERROR CODE 


MESSAGE 




36 


IJQ073 


ILLEGAL NAME FIELD 




65 


IJ0059 


UNDEFINED SEOUENCE SYMBOL 




66 


IJQ037 


MNOTE STATEMENT 




67 


IJQ088 


UNDEFINED OPERATION CODE 




90 


IJQ023 


PREVIOUSLY DEFINED NAME 




151 


IJ0039 


INVALIO DELIMITER 




6 


STATEMENTS 


FLAGGED IN THIS ASSEMBLY 





PAGE 



DIAGNOSTICS 



This section contains the diagnostic 
messages issued as a result of error 
conditions encountered in the program. 
Explanatory notes for each message are 
contained in Appendix N. 



IJQ 



IJY 



identifies the issuing agent as 
DOS/TOS D assembler. 



identifies the issuing agent as 
DOS F assembler. 



o 



This column contains the number of the 
statement in error. 



This column contains the message 
identifier. 



This column contains the message. 



The following notes apply to the 
diagnostics section: 



XXX 



is a unique number assigned to the 
message. 



Two statistical messages may appear in 
the listing. They are: 



1. A message indicating the total 

number of statements in error. If 
no statements are in error, the 
message 



An MNOTE indicator of the form MNOTE 
STATEMENT appears in the diagnostic 
section, if an MNOTE statement is 
issued by a macro instruction. The 
MNOTE statement itself is inline in 
the source and object program section 
of the listing. 



NO STATEMENTS FLAGGED IN THIS 
ASSEMBLY 



is printed following the 
Cross-Reference section and no 
diagnostic section is printed. 






A message identifier consists of six 
characters and is of the form: 



IJQxxx 



IJYxxx 



A message if one or more Y-type 
address constants appear in the 
program. 



AT LEAST ONE RELOCATABLE Y-TYPE 
CONSTANT IN ASSEMBLY. 



This message if issued, appears 
before the diagnostic section. 
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Appendix J. Assembler Language-Features Comparison Chart 



o 



Features not shown below are common to all assemblers. In the chart: 

Dash = Not allowed. 

X = As defined in IBM Operating System/360 Assembler Language , GC28-6514 

Op (s) = Operand (s) . 



7090/7094 
Support 
Package 
Assembler 



T 1 

OS/360 
Assembler 
DOS F 
Assembler 



r catuie 



Model 20 

Basic 

Assembler 



BPS/36 O.- 
Basic 
Assembler 



BPS 8K Tape 
BOS 8K Disk 
Assemblers 



DOS,TOS 
D Assem- 
blers 



No. of Continuation 
Cards/Statement 
(exclusive of macro 
instructions) 















Input Character 
Code 



EBCDIC 



EBCDIC 



BCD 
EBCDIC 



EBCDIC 



EBCDIC 



EBCDIC 



ELEMENTS : 



Maximum Characters 
per symbol 



Character 

self- defining terms 

Binary self-defining 
terms 



1 Char only 



1 Char only 






4 

x 



X 



— 1 



V 



Length attribute 
reference 
j. 

Literals 

Extended mnemonics 

Maximum location 
counter value 






2 1«*-1 |2« B -1 



X 
2 a *-1 






<T _ 



X 
X 
2 al »-1 



X 

4 

X 

i 

2 2 *»-1 



X 
+— 

X 

+ 

2 a **-1 



i 



Multiple Control 
Sections per 
assembly 

EXPRESSIONS: 



X 






Operators 



+ - 
3 



+-* 



+-*/ 
16 



♦-*/ 



+-*/ 



♦-*/ 



Number of terms 



16 



Levels of 
parentheses 



16 
5 



Complex 
relocatability 



(Part 1 of 3) 
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T T 

7090/7094 
Support 
Package 
Assembler 



t ^ 

OS/360 | 
Assembler j 
DOS F j 
Assembler j 
1 



Feature 



Model 20 

Basic 

Assembler 



BPS/360: 
Assembler 



BPS 8K Tape 
BOS 8K Disk 
Assemblers 



DOS,TOS 
D Assem- 
blers 



ASSEMBLER 
INSTRUCTIONS 



DC and DS 



Expressions allowed 
as modifiers 



Multiple operands 



Less than j 
33 I 



Multiple constants 
in an operand 



Except 
Address 
Consts . 



H 



Bit length 
specifications 



H 

I 

H 

I 



Scale modifier 



Exponent Modifier 



DC types 



f 

Only 
C,X, 

H,Y,Q 



Except 
B,P,Z, 
V,Y,S,Q,L 



+ 

Except 
B,V,Q,L 



Except Q 



4 

Except Q 1 






H 
I 
t 

H 
I 
I 

H 
I 
t 

H 
I 
i 

H 
I 

H 
I 
I 



DC duplication 
factor 



Except Y 



Except A 



Except S 



X 



DC duplication 
factor of zero 



Except Y 



Except S 



DC length modifier 



DS types 

DS length modifier 

DS maximvim length 
moditier 

DS constant subfield 
permitted 



Except 
H,Y 

Only 
H,C, 

Only C 

256 






Except 
H,E,D 

Only C, 
H,F,D 

Only C 

256 



+ 

Only C, 

H,F,D 
+ 

Only C 

+ 

256 






X 
X 
256 









X 



X 
65,535 

X 



l x 

|x 

|x 

65,535 
X 



COPY 



CSECT 
h 



■H 



DSECT 
y 

ISEQ 
LTORG 






* The TOS Assembler and the 10K variant of 

constants. 
2 DOS F Assembler does not allow Q-type or 



the DOS Assembler D do not allow L-type 
L-type constants. 



(Part 2 of 3) 
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Feature 



PRINT 
TITLE 
COM 
ICTL 



USING 



DROP 
CCW 



ORG 



ENTRY 



EXTRN 
WXTRN 
CNOP 



PUNCH 



I'- 
ll 

h 

REPRO 

Macro 
Instructions 



Model 20 

Basic 

Assembler 



2 ops (op 1 
relocatable 



1 op only 



no blank op 



1 op only 



1 op only 



S/360 
Model 20 
IOCS only 



BPS/360: 

Basic 

Assembler 



1 op (1 or 
25 only) 



2 ops (op 1 
relocatable 



1 op only 



op 2 (relo- 
catable 
only) 



no blank op 



1 op only 



1 op only 
faax 14) 



DOS 14K 
D only 



2 decimal 
digits 






7090/7094 
Support 
Package 
Assembler 



1 op 



2-17 (ops 
relocat- 
able 
only) 



no blank 
op 



1 op only 
1 op only 



2 decimal 
digits 



BPS 8K Tape 
BOS 8K Disk 
Assemblers 



6 ops 



5 ops 



1 op only 
1 op only 



2 decimal 
digits 



X 






DOS,TOS 
D Assem- 
blers 



T 1 

OS/360 
Assembler 
DOS F 
Assembler 

-I 

X 

4 



1 

1 






Part 3 of 3) 



o 



W 



J 
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o 



j |BPS 8K Tape, j | j 
| |BOS 8K Disk j DOS, TOS j OS/360 j 
j Macro Facility Features j j Assemblers j Assemblers! Assembler j 

L _ _ . L J. J. J 


|Operand Sublists | 


i * 




X I 


| Attributes of macro instruction operands inside macro j 
(definitions and symbols used in conditional assembly j 
| instructions outside macro definitions. | 


I X 




X I 


J Subscripted SET symbols j 


t * 






j Maximum number of operands j 49 


I 100« 




200 | 


(Conditional assembly instructions outside macro j 
(definitions j 


I X 




x I 


j Maximum number of SET symbols j 








| global SETA | 16 


I + 




+ I 


| global SETB | 128 


I .+ 




+ I 


( global SETC | 16 


I + 




+ I 


| local SETA (16 


I + 




+ I 


| local SETB J 128 


I + 




+ I 


| local SETC | 


I + 


l+ I 


j 1 Maximum number of operands in DOS assembler F is 200. j 
(+ The number of SET symbols permitted by the Disk and Tape Operating Systems Assemblers j 
j and the IBM System/360 Operating System Assembler is variable, dependent upon the | 
| available main storage. j 


(Note: The maximum size of a character expression is 127 in DOS 


(assembler 


D \ 


and TOS ( 


land 255 characters in OS and DOS (assembler F) . 
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Appendix K. Card Input for Assembly Runs 



O 



Figure 22 lists the control cards necessary to assemble a program. The card groups are 
listed in the order in which they must appear. All job control cards enter the system 
via SYSRDR, all others via SYSIPT. The same device may be assigned for both SYSRDR and 
SYS1PT. If this device is a disk file, the combined file must be designated as SYSIN. 
Job control statements are described in the publications IBM System/360 Disk Operating 

System: System Control and System Service Programs or IBM System/360 Tape Operating 

Sys tem: Sys tem Control and System Service Programs . 



, 1 ,_.. 

| Card Group |Card Arrangement 



Comments 



(Job Control 


i // 

1 * r 


JOB .. 




First card in group, always required. 










ASSGN 


SYSCLB 


Used when the core image library is on a separate 
(private) file (see Note 3) . 








1// 


ASSGN 


SYSSLB,.. 


Used when the source statement library is on a 
separate (private) file. 1 








1// 


ASSGN 


SYSIPT,.. 


Source program input. 








1// 


ASSGN 


SYSLST,. . 


Program listing. 








1// 
1// 
1// 


ASSGN 
ASSGN 
ASSGN 


SYS001,... 
SYS002,. .. 
SYS003,... 


Work files. 








1// 


ASSGN 


SYSPCH , . . 


Required when DECK option is specified. 








1// 


ASSGN 


SYSLNK , . . 


Required when assemble-and-execute is specified. 








1// 


OPTION DECK,... 


Optional. Used to indicate desired assembler 
functions. 








1// 

_J 


EXEC ASSEMBLY 


Required. 


I 


r 

(Assembler 

| Input 




T T 

| Source Deck | Source statements (machine, 

j j assembler, and macro instructions) . 


I 






1/* 




— -U 


Indicates end-of-data set. 


i 


r — ~ " 

|Job Control 


1/6 
_j 




| End -of -job statement. 
j. 


a 


| 1 SYSSLB is 


assigned as follows: 






| For DOS — SYSSLB cannot be assigned for the 10K assembler. If SYSSLB is assigned for 
j the 14k D assembler or the F assembler, it is concatenated with the source statement 
| library on SYSRES. (The assembler searches first SYSSLB and then the SYSRES 
| library.) The 10K D assembler and if SYSSLB is not assigned the 14K D and F 
| assemblers use only the source statement library of SYSRES. 




I For TOS- 
j library 
| use the 


—Both TOS assembler variants use either SYSSLB or the source statement 
on SYSRES. They use SYSSLB if it is assigned. If it is not assigned, they 
SYSRES library. 





vV 



Figure 22. Card Input for an Assembly (Part 1 of 2) 
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Note 1 ; Only those assignments and options not already in effect are required. 



Note , 2 ; Assignments for SYSIN and/or SYSOUT must be accomplished by permanent 
assignments. For details see the publications for DOS and TOS system control and 
system service programs. 

Note 3 : Normally the assembler and the linkage editor can be executed in the 
background only. However, in a Disk Operating System that supports the batched- job 
foreground and private core image library options, the assembler and the linkage editor 
can also be executed in any of the foreground partitions provided that the partition is 
2K bytes larger than the minimum main storage area required by the assembler; then the 
appropriate private core image library must be assigned instead of the library on the 
system residence device (SYSRES) . A private core image library must be assigned with a 
job control command (a job control command differs from a job control statement in that 
it does not have slashes in columns 1 and 2) , which makes it a permanent assignment. 
It remains in effect until another ASSGN command for SYSCLB is encountered. 



o 



Figure 22. Card Input for an Assembly (Part 2 of 21 



o 
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I Symbolic Unit (Remarks 



| Function and Device 



SYSRDR 



SYSIPT 



SYSIN 



SYSLST 



SYSPCH 



Required if the SYSIN 
option is not used. 



Required if the SYSIN 
option is not used. 



Required for combined 
disk input. 

Optional for combined 
card or tape input. 



Required if the SYSOUT 
option is not used. 



Optional , 



Job control statement input device. May fce the 
same device as SYSIPT except for combined input 
from IBM 2311, 2314, or 2319 Disk Extent (see 
SYSIN) . 



IBM 1442, 2520, or 2540 Card Read Punch, IBM 2501 
Card Reader, IBM 2400-series Magnetic Tape Unit, 
or IBM 2311, 2314 or 2319 Disk Extent for the 
disk system. 



Source program input device. May be the same 
device as SYSRDR except for combined input from 
IBM 2311, 2314, or 2319 Disk Extent (see SYSIN). 

IBM 1442, 2520, or 2540 Card Read Punch, IBM 2501 
Card Reader, IBM 2400-series Magnetic Tape Unit 
(7-or 9-track), or IEM 2311, 2314, or 2319 Disk 
Extent for the disk system. If the Data 
Conversion feature was used to prepare the 
7-track tape, it must also be used to read the 
tape. The tape or disk records must be 80-byte 
unblocked records. 



Used for a combined input file for SYSRDR 
and SYSIPT. 

IBM 1442, 2520, or 2540 Card Read Punch, IBM 2501 
Card Reader, IBM 2400-series Magnetic Tape Unit, 
or IBM 2311, 2314, or 2319 Disk Extent for the 
disk system. 

SYSIN can be used in lieu of the SYSER and SYSIPT 
designation when the file is card or tape input. 
It must be used when the file is disk input (disk 
system only) . 



Program listing device. 



IBM 1403, 1404 (continuous forms only), or 1443 
Printer. IBM 2400-series Magnetic Tape Unit 
(9-track, or 7-track with or without the Data 
Conversion feature) or IEM 2311, 2314, or 2319 
Disk Extent for the disk system. 

Listing on tape or disk appears as 121- character 
print images (a single forms control followed by 
a 120-character line image) . 



Object program output device. 

IBM 1442, 2520, or 2540 Card Read Punch. IEM 
2400-series Magnetic Tape Unit (9-track, or 
7-track with the Data Conversion feature) , or IEM 
2311, 2314, or 2319 Disk Extent for the system. 

Output on tape or disk is in 81-byte unblocked 
records. 

Not used when the assemble-and-execute or the 
NODECK option is specified. 



Figure 23, 
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Device Assignments (Part 1 of 2) 



4^ 



o 



© 



I Symbolic Unit J Remarks 

i- -H- 



SYSOUT 



SYSLNK 



SYS001 
SYS002 
SYS00 3 



SYSCLB 



SYSSLB 



Optional 



Optional 



Required 



Optional 



Optional 



j Function and Device 



j Used for a combined output file for SYSLST and 
SYSPCH to a single tape unit. 

IBM 2400-series Magnetic Tape Unit (9-track, or 
7-track with the Data Conversion feature) . 



Used for temporary storage of assembler output. 
Required only when the assemble- and- execute 
option is specified. 

IBM 2400-series Magnetic Tape Unit (9-track, or 
7-track with the Data Conversion feature) for the 
tape system or IBM 2311, 2314, or 2319 Disk 
Extent for the disk system. This extent may be 
on the same device that contains the DOS resident 
system. 



Used for temporary work area during assembly. 
IBM 2400-series Magnetic Tape Unit (9-track, or 
7-track with the Data Conversion feature) for 
either the tape or disk systems or three IBM 
2311, 2314, or 2319 Disk Extents for the disk 
system. These extents may be on the same device 
that contains the DOS resident system. 

For details of work file assignement, see the 
publication for DOS system generation. 



May be used only on a DOS system that supports 
the private core image library option. Must fce 
the same device type as SYSRES. See also Note 3 
in Figure 22. 



Must be same device as SYSRES 
Figure 31. 



See Appendix M, 



Note ; The 2311, 2314, or 2319 can be used for one or more of the symbolic units 



SYSRDR, SYSIPT, SYSIN, SYSPCH, or SYSLST only if a supervisor has been SYSGEN'd that 
can accommodate input from disk storage or output to disk storage for these units. For 
details see the DOS system generation manual. 



Figure 23. Device Assignments (Part 2 of 2) 



r 1 

I Input and Output Using an IBM 14 42 or 2520 Card Read Punch ; Whenever an IBM 1442 or 
| 2520 Card Read Punch is assigned tc SYSRDR , SYSIPT, or SYSIN and also to SYSPCH, a 
j number of blank cards sufficient for punching the output deck must follow the /* card 
| follows the assembler END statement in the source deck. This is to prevent erroneously 
j punching the cards of a following job step. Any extra cards that are not needed are 
| automatically bypassed. 

L_, 



Figure 24. Operating Considerations 
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I Card Group 
j. 

Job Control 



| Card Arrangement 
f 

// JOB , . . 

// ASSGN SYSRLB.. 



// ASSGN SYSSLB.. 

// ASSGN SYSIPT. . 

// ASSGN SYSLST.. 

// ASSGN SYSLNK.. 

// ASSGN SYS001.. 
// ASSGN SYS 00 2.. 
// ASSGN SYS003.. 

// OPTION LINK... 
// EXEC ASSEMBLY 



j Comments 

+ 

First card in group, always required. 

Used by the linkage editor when the relocatable 
library is on a separate (private) file and 
previously assembled modules are to be included. 

Used when the source statement library is on a 
separate (private) file." 

Source program input. 

Program listing. 

Required for assemble-and- execute. 



Work files. 



Required. Used to indicate LINK option and any 
additional assembler functions desired. 

Required. 



Assembler Input 
Source Deck 



/♦ 



Source statements (machine, assembler, and 
macro instructions) Note ; If the operand of the 
END statement is omitted, a PHASE card must 
precede the // EXEC ASSEMBLY card or an ENTRY 
card must follow the END statement (tape system 
only) . 

Indicates end-of-data set. 



Job Control 



ENTRY. . . 
// EXEC LNKEDT 
// EXEC 



Calls the linkage editor. 



Data 



Data, if any 
/* 



End-of-data set indicator. 



Job Control 



I/6 



j End-of-job statement 

.x . — 



* See Figure 22. 

Note 1 : Only those assignments and options not already in effect are required. 



Note 2 ; Assignments for SYSIN and/or SYSOUT must be accomplished by permanent 
assignments. For details see the publications for DOS and TOS system control and 
system service programs. 



Figure 25. Card Input for Assembly, Linkage Editing, and Execution 
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%J 



Note: 
Broken lines indicate 
where the Assembler 
input would be placed 
if SYSIPT were the 
same unit as SYSRDR. 



Optional — ■/ "?// ASSGN SYSSLB,. . ." 



Optional — *f// ASSGN SYSLNK,. . . 
(7/ASSGNSYSLST,.. .! 



I SYSIN 
L I (Optional) 




SYSOUT 
(Optional) 



I 

-J 
SYSPCH 
(Optional) 



:_ SYSLNK 
(Optional) 



See Figure 25. 



Figure 26. I/O Units Used by the Tape Assembler 
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Note: 
Broken lines indicate 
where the Assembler 
incut would be placed 
ifSYSIPT were the 
same unit as SYSRDR. 

If SYSIPT and 
SYSRDR are the same 
disk unit, they must be a 
combined file assigned 
asSYSIN. 

Opt iona I 



System 
Pack 



Optional ■ 
Optional 



^ 



{// EXEC ASSEMBLY 

'ASSGN SYSSLB 
ASSGN SYSPCH,... 




{// ASSGN SYS003, . . . 
f// ASSGN SYS002,.. 



7ASSGNSYS001 , ... 



7 ASSGN SYSLNK,. . 



ASSGN SYSLST, 



|/7 ASSGN SYSIPT, 



//OPTION .. 



//ASSGN SYSC LB,... 



//JOB 



SYSSLB 
(Optional) 




System/360 




See Figure 25. 




"% 



f 

> i 



J 






o 



/" 



--'I 



I 



SYSIN 



\ 

) 
1 / 

I 



(Required if SYSRDR 
and SYSIPT are a 
combined disk file. 
Optional if SYSRDR 
and SYSIPT are a 
combined card or 
tape file.) 



^ 



'/ ' \ SYS001 
— V / SYS002 



J — i ' ' 

Tyspch 



SYS002 
SYSLNK ^^Z'-^ SYS0G3 

(Optional) ~ 



(Optional) 



SYSOUT 
(Optional) 



J 



SYSC LB 
(Optional) 



Figure 27 . I/O Units Used by the Disk Assembler 
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Assemble- and- execute 



// JOB... 

// ASSGN SYSIPT., 

// ASSGN SYSLST,, 

// ASSGN SYS001,. 
// ASSGN SYSG02,, 
// ASSGN SYS003,, 

// ASSGN SYSLNK,. 

// OPTION LINK,., 

// EXEC ASSEMBLY 



Source Deck 
/* 



ENTRY 

// EXEC LNKEDT 



Assemble -and -execute 
(Include object 
routines from the 
relocatable library) 



// JOB... 

// ASSGN SYSIPT. . 

// ASSGN SYSLST,. 

// ASSGN SYS 001,. 
// ASSGN SYS002,. 
// ASSGN SYS003,. 

// ASSGN SYSLNK,. 

// OPTION LINK,.. 

// EXEC ASSEMBLY 



Source deck 
/* 



INCLUDE SUBR1 
INCLUDE SUBR2 



ENTRY 

// EXEC LNKEDT 



Assemble-and-execute 
(Include object 
routines from cards) 



// JOB... 

// ASSGN SYSIPT. . 

// ASSGN SYSLST, . 

// ASSGN SYS001,. 
// ASSGN SYS002,. 
// ASSGN SYS003,. 

// ASSGN SYSLNK,. 

// OPTION LINK, . . 

// EXEC ASSEMBLY 



Source deck 
/* 



INCLUDE 
Object deck (s) 
/* 



ENTRY 

// EXEC LNKEDT 



Assemble-and-execute 
(Include object 
routines from the 
relocatable library 
and from cards 



// JOB. . . 

// ASSGN SYSIPT.. 

// ASSGN SYSLST,, 

// ASSGN SYS001,, 
// ASSGN SYS 00 2,, 
// ASSGN SYS003,, 

// ASSGN SYSLNK,, 

// OPTION LINK,.. 

// EXEC ASSEMBLY 



Source deck 
/* 



INCLUDE SUBR1 
INCLUDE 
Object deck (s) 

/* 

INCLUDE SUBR2 

INCLUDE SUBRT 
ENTRY 

// EXEC LNKEDT 



Any job control cards needed for the programs to be executed. 
// EXEC |// EXEC |// EXEC |// EXEC 



¥ 

Data, if any JData, if any 

/* I/* 

_ i 


-_ + 

| Data, if any 

I/* 

j 


._+ 

JData, if any 

I/* 

. t 


/g |/g 

. _ _ _j 


l/s 

__JL___ _._ 


— |. — « — 


If SYSRDR and SYSIPT are different units, 
in SYSRDR, and should be placed after the 


a/g card must placed 
last /* in SYSIPT. 


after the last EXEC card 



Figure 28 . Card Input for Different Variations of Assembly, Linkage Editing and 
Execution 
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Appendix L. Replacing the Current Assembler 



The EXEC ASSEMBLY statement causes the job 
control program to look for a phase with 
the name ASSEMBLY in the Core Image Library 
and load it into main storage. Since 
duplicate names cannot appear in a library, 
and every version of the assembler 
processor has the same phase name, only one 
of them can be in the Core Image Library at 
a time. Therefore the variant best suited 
for the particular installation is normally 
included in the Core Image Library. The 
programmer can, however, select another 
variant from the Relocatable Library and 
include it in the Core Image Library 
instead of the variant that is already 
there. 

Figure 29 shows the job control cards 
required to bring a particular assembler 
variant from the Relocatable Library into 
the Cbre Image Library, and Figure 30 shows 
the valid assembler names (the names under 
which the variants would be cataloged in 
the Relocatable Library). After the 
variant has been included in the Core Image 
Library, it can be loaded and executed 
through the EXEC ASSEMBLY statement. 



I// 
I// 



l/« 

I// 

I// 

I 

I// 



JOB CONDENSE 
EXEC MAINT 
DELETC ASSE.ALL 
CONDS CL 

JOB LINKASM 
OPTION CATAL 
INCLUDE name 1 
EXEC LNKEDT 



This job not 
needed in TOS 



j 1 e name e selected from those listed in 
| Figure 30. 

Figure 29. Card Input for Selecting 

Different Assembler Variants 

Variants 1JQT16, IJQD16TW, and IJQD16DW 
must be used if the assembler is to be run 
in less than 14K of available core. 
Variants IJQT32 and IJQD32 may be used if 
available core is never less than 14K. 
The IJQ variants are D assemblers. 
Variant IJYASM (the DOS F assembler) may 
be used if available core is never less 
than 45,056 bytes. 

IJQT32 andIJQD32 are generally faster 
than LJQT16 and IJQD16DW or IJQD16TW, 
respectively, because they have test i/o 
buffering and can use the additional core 



to build larger symbol tables. The 
difference in speed varies with the amount 
of additional core and the number of 
symbols in the assembly. 

Thus, if the assembly has few symbols 
or if only a small amount of additional 
core is available to a larger variant, the 
larger and smaller variants will be nearly 
equal in speed. 

For comparable assemblies? DOS 
assembler F (IJYASM) is up to 45X faster 
than DOS assembler D. 

Note 1 : The descriptions 16K and 32K 
refer to the machine size required to run 
the 10K and 14K variants respectively 
(except that the 14K variant can run on a 
IBM System/360 Operating System Model 30 
with 24K of core) . 

Note 2 : Some installations have two or 
more assemblers in the Core Image Library. 
In such instances , the phase names have 
been changed to avoid duplicate names in 
the library. (Refer to IBM System/360 
Disk Operating System; System Generation 
and Maintenance , and IBM System/360 Tape 
Operating System: System Generation and 
Maintenance.) 



r t t T 1 

I Name | System | Work Files 1 | Minimum Core 2 J 



h 



,. + 4 + ., 



IJQD16DWJDOS 

I 
IJQD16TWJDOS 

I 
IJQD32 [DOS 

I 
IJYASM I DOS 



JDisk 

I 

| Tape 

I 

I Mixed 



Mixed 



|10,240 

I 
|10,240 

I 
|14,336 

I 
|45,056 



IJQT16 | TOS | Tape 

I I 
IJQT32 | TOS JTape 



110,240 

I 
|14,336 



j. j. x x .j 

1 Mixed work files mean any combination 
of 2400-series tapes and/or 2311 and/or 
2314 disk extents for SYS001, SYS002, 
and SYS003. In general, the assembler 
uses SYS001 and SYS002 as serial files 
and SYS003 as a random access file. 

a Minimum core refers to the minimum 
number of contiguous bytes necessary 
for the particular assembler variant to 
function correctly. 

L 

Figure 30. Assembler Variants 



(a 



J 



O 

4^ 
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Appendix M. Object Deck Output 



Figure 31 lists the card groups that make 
up the output deck produced by the 
assembler. The groups are listed in the 
order in which they appear in the output 
deck. 



Note ; No output deck will be produced when 
NODECK appears in the OPTION card. 

The formats of the ESD, TXT, RLD, END, 
and SYM cards are shown in Figures 32 and 
33. 



o 



r , T 

(Card Group | Remarks 



Reproduced Cards 

Symbol Table (SYM) 

External Symbol Dictionary (ESD) 

Problem Program 

Relocation Dictionary (RLD) 
END Card 

i. j. „ ^ 

Object Deck Identification 



These reproduced cards result from REPRO or PUNCH 
instructions located before START. 

Produced when SYM appears in the OPTION card. 



Consists of text (TXT) and reproduced cards. The 
reproduced cards result from REPRO or PUNCH 
instructions located after START. 

Produced if relocatable constants are present. 

Produced as the last card of the output deck. 



The 4-character assembly identification label punched into the name entry of the first 
TITLE card in the source program is punched into columns 73-76 of each record in the 
object deck. If there is no label, these columns are left blank, 
j. 1 

Obje ct Deck Sequencing Numbering 



An assembler-generated sequence number is punched into columns 77-80 of each card in 
the object deck, 
i j 






Figure 31. Assembler Output Deck 
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The information in each card is in Extended Binary Coded Decimal Interchange Code. 



r t 

Columns | Punched 
f x 

ESD Card 
j. 



2-4 



11-12 



15-16 



17-72 



73-76 



77-80 



Multiple punch (12-2-9) . 
Identifies this as a loader card. 

ESD — External Symbol Dictionary 
card. 

Number of bytes of information 
contained in this card. 

External symbol identification 
number (ESID) of the first SD, 
PC, WX, or ER on this card. 
Relates the SD, PC, WX, or ER to 
a particular control section. 

Variable information. 



•8 positions. 
•1 position. 

indicate SD, 

ER. 
•3 positions. 

origin. 
•1 position. 
•3 positions 



Name. 
Type code to 
WX, PC, LD, or 

Assembled 



Blank. 
Control section 
length, if an SD-type or a 
PC- type. If an LD-type, this 
field contains the external 
symbol identification number 
(ESID) of the SD or PC 
containing the label. 

Program identification taken form 
the name field of the first TITLE 
statement. 



Sequence number. 



TXT Card 



1 | Multiple punch (12-2-9) . 

| Identifies this as a loader card. 
2-4 | TXT— Text card. 
6-8 (Assembled origin (address of 

| first byte to be loaded from this 
j card) . 
11-12 J Number of bytes of text to be 

| loaded. 
15-16 {External symbol identification 
j number (ESID) of the control 
j section (SD) containing the text. 
17-72 j Up to 56 bytes of text — data or 
j instructions to be loaded. 



H f- 



r T* 

| Columns | Punched 



- + ^ 

73-76 j Program identification taken from} 
(the name field of the first TITLE 
J statement. 



77-80 [Sequence number, 



RLD Card 



1 

2-4 

11-12 

17-72 



73-76 



77-80 



Multiple punch (12-2-9) . 

RLD — Relocation Dictionary card. 

Number of bytes of information 
contained in the card. 

Variable information (multiple 
items) . 

•2 positions. Pointer to the 

relocation factor of the 

contents of the load constant. 
•2 positions. Pointer to the 

relocation factor of the 

control sections in which the 

load constants occurs. 
•1 position. Flag indicating 

type of constant. 
•3 positions. Assembled 

address of load constant. 

Program identification taken form 
the name field of the first TITLE 
statement. 

Sequence number. 



END Card 



1 JMultiple punch (12-2-9) . 
2-4 J END 
6-8 (Assembled origin of the label 

(supplied to the Assembler in the 

j END card (optional) . 
15-16 j ESID number of the control 

j section to which this END card 

| refers. 
17-22 | Symbolic label supplied to the 

J Assembler if this label was not 

(defined within the assembly. 
73-76 (Program identification taken from 

(the name field of the first TITLE 

| statement . 
77-80 j Sequence number. 



o 



_y 



Figure 32. Format of ESD, TXT, RLD, and END Cards 
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I i 



o 



r T 

| Columns | Contents 

j. + 

1 j 12-2-9 punch 

2-4 |SYM 

5-10 | Blank 

11-12 | Number of bytes in the Variable Field 

13-14 JBlank 

15-16 JESID 

17-72 | The Variable Field (see below) 

73-76 j Deck ID (from the first TITLE card) or blank 

77-80 j Card sequence number 

j. x_ 



The variable field (columns 17-72) contains up to 56 bytes of AUTOTEST text. The items 
making up the text are packed together; consequently the last card may contain less 
than 56 bytes of text in the variable field. The contents of the fields within an 
individual text item are, as follows: 

1 .Organization (1 byte) : 



Bit 





: 


Bit 


1 


1 


Bit 


2 


■ 1 


Bit 


3 


1 



1 = DC or DS 
Bit 4 : 

= not DC or DS 
Bits 5-7: Length of name minus one. 



Address (3 bytes) 



displacement from base of control section, 



3. Symbol Name (1-8 bytes): symbolic name of the particular item. 
The following fields are present only for data-type items: 

4. Data Type (1 byte): 

X'OO character 

X'04" hexadecimal 

X'08' binary 

X'10' full word, fixed point 

X'14' half word, fixed point 

X*18* single precision floating point 

XMC* double precision floating point 

X'20* A-type or Q-type address constant 

X'24* Y-type address constant 

X'28* S-type address constant 

X'2C V-type address constant 

X'30' packed decimal 

X'34' zoned decimal 

5. Length (1-2 bytes): length of data item minus one. Occupies two bytes for 
character, hexadecimal and binary items; otherwise one. 



6. Multiplicity (1 byte) 



always X'OT. 



o 



Figure 33. Format of the SYM card. 
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New text can be substituted for 
assembled text using the REP card. Each 
REP card must contain the assembled address 
of the first byte to be replaced and the 
identification of the control section to 
which it refers, and may contain from two 
to 22 bytes of text. The text is 
substituted, byte for byte, for the 
original text, beginning at the address 
specified. The address, the control 
section reference, and the new text must be 
stated in hexadecimal. The REP card must 
be placed after the TXT cards in the object 
module that it modifies. Its format is 
shown in Figure 34. 



r t 

J Columns J Contents 



1 iMultiple punch (12-2-9) . 

Identifies this as a loader card, 

2-4 I REP — Replace text card. 

5-6 | Blank. 

7-12 iAssembled address of the first 
byte to be replaced 
(hexadecimal) . Nust be right 
justified with leading zeros if 
needed to fill the field. 

13 | Blank. 

14-16 | External symbol identification 
number (ESID) of the control 
section (SD) containing the text 
(hexadecimal) . Must be right 
justified with leading zeros if 
needed to fill the field. 

17-70 | From one to eleven 4-digit 

hexadecimal fields separated by 
commas, each replacing two bytes. 
A blank indicates the end of 
information in this card. 

71-72 iBlank. 

73-80 JKay be used for program 
identification. 



o 



Figure 34. Format of the REP card, 
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Appendix N. Diagnostic Error Messages 



Diagnostic error messages are printed 
following the cross-reference listing, in 
statement number order. The message code 
has the form IJQnnn for the D assembler and 
IJYnnn for the F assembler. Figure 35 



lists the diagnostic messages and their 
message codes. If errors are encountered 
while editing library macros, the statement 
number referenced will be that of the "END" 
statement. 



^^F 



Message 
Code 



IJQ 001 
IJY 



IJQ 
IJY 

IJQ 
I3Y 

IJQ 
IJY 

IJQ 
IJY 

IJQ 
IJY 



IJQ 
IJY 

IJQ 
IJY 

IJQ 
IJY 

IJQ 
IJY 



002 



003 



004 



005 



006 



007 



008 



009 



010 



Message 



DUPLICATION FACTOR ERROR 



RELOCATABLE DUPLICATION FACTOR 



LENGTH ERROR 



RELOCATABLE LENGTH 



S-TYPE CONSTANT IN LITERAL 



INVALID ORIGIN 



LOCATION COUNTER ERROR 



INVALID DISPLACEMENT 



MISSING OPERAND 



INVALID SPECIFICATION OF REGISTER 
OR MASK FIELD 



Meaning 

_ _._ H 

Duplication factor: 

1. Is zero in a literal. 

2. Is not a positive absolute expression. 



Duplication factor is relocatable. 



1. Out of permissable range, 

2. Invalid specification. 

Length is relocatable. 



S-type constant in literal 



Location counter has been reset to a value 
less than the starting address of the control 
section. 

Location counter has exceeded 2 2 *»-1. 



Displacement in an explicit address is not 
within 0-4095. 

Operand is missing. 



1. The register or mask field specification 
not an absolute value. 

2. The register or mask field specified not 
in the range 0-15. 

3. An odd register specified where an even 
register is required (multiply, divide, 
and shift instructions) . 

4. The register specified is not a floating 
point register (floating point 
instructions) . 

5. The register specified is not an 
extended precision floating point 
register (extended precision floating 
point instructions) . 

6. The immediate field specified for an SRP 
instruction not in the range - 9 . 






Figure 35. Assembler Diagnostic Error Messages (Part 1 of 14) 
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| Message 
J Code 


Message 

L._____________ ________J 


Meaning 








JIJQ 011 
| IJY 


SCALE MODIFIER ERROR 


! Scale modifier is : 

1. Too large, 
! 2. Not an absolute expression. 


JIJQ 012 
| IJY 


RELOCATABLE SCALE MODIFIER 


Scale modifier is not allowed to be 
relocatable. 


JIJQ 013 
| IJY 

JIJQ 014 
| IJY 


EXPONENT MODIFIER ERROR 
RELOCATABLE EXPONENT MODIFIER 


Exponent is: 

1. Out of range. 

2. Not specified as an absolute expression. 
Exponent modifier is not allowed to be 
relocatable. 


| IJQ 015 
j IJY 


INVALID LITERAL USAGE 


A valid literal is used illegally, 
!e.g., specifies a receiving field or a 
register. 


JIJQ 016 
| IJY 


INVALID NAME 


Name entry incorrectly specified — 

1. Contains more than 8 characters. 

2. Does not begin with a letter. 

3. Has a special character imbedded. 


| IJQ 017 
| IJY 


DATA ITEM TOO LARGE 


The constant is too large for: 

1. The data type. 

2. The explicit length. 


| IJQ 018 
I IJY 


INVALID SYMBOL 


The symbol specification is invalid, 
e.g., longer than 8 characters, embedded 
special character. 


| IJQ 019 
| IJY 


EXTERNAL SYMBOL ERROR 


1. Identical name entry in a CSECT 
and a D SECT statement. 

2. Identical operands in one or more 
EXTRN/WXTRN statements. 


| IJQ 020 
|IJY 


INVALID IMMEDIATE FIELD 


1. The immediate field is not an absolute 
! expression. 

! 2. The value of the immediate field 
is not in the range 0-255. 


JIJQ 021 
JIJY 


SYMBOL NOT PREVIOUSLY DEFINED 


A statement requiring predefined symbols 
[contains a symbol not predefined. 


| IJQ 022 
JIJY 


ESD TABLE OVERFLOW 


[The total number of control sections, dummy 
[sections, and unique symbols in EXTRN 
statements and V-type constants exceeds 255. 


| IJQ 023 
I IJY 


PREVIOUSLY DEFINED NAME 


The symbol in the name entry has appeared 
| in the name entry of a previous statement. 


| IJQ 024 
JIJY 


UNDEFINED SYMBOL 


A symbol being referenced has not been 
[defined in the program. 


| IJQ 025 
| IJY 


RELOCATABILITY ERROR 


| A relocatable or complex relocatable 
[expression is specified where an absolute 
| expression is required. 



Figure 35. Assembler Diagnostic Error Messages (Part 2 of 14) 
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r t 

Message 
Code 



IJQ 026 
IJY 

IJQ 027 
IJY 

IJQ 028 
IJY 

IJQ 029 
IJY 

IJQ 030 
IJY 

IJQ 031 
IJY 

IJQ 032 
IJY 



IJQ 033 
IJY 



IJQ 034 
IJY 



IJQ 035 
IJY 

IJQ 036 
IJY 



IJQ 037 
IJY 



Message 



TOO MANY LEVELS OF 
PARENTHESES 

TOO MANY TERMS 



REGISTER NOT USED 



CCW ERROR 



INVALID CNOP 



UNKNOWN TYPE 



OP-CODE NOT ALLOWED TO 
BE GENERATED 



ALIGNMENT ERROR 



INVALID OP-CODE 



ADDRESSABILITY ERROR 



OPERAND FIELD 
MUST BE BLANK 



MNOTE STATEMENT 



Meaning 



Expression specifies more than 5 levels 
of parentheses. 

More than 16 terms specified in an 
expression. 

A register specified in a DROP statement 
is not currently in use. 

Bits 37-39 of the Channel Command Word are 
set to nonzero. 

Invalid range. 



Incorrect type designation in a DC, 
DS, or literal. 

Operation code allowed only in source 
statement has been obtained through 
substitution of a value for a variable 
symbol . 

Referenced address is not aligned to the 
proper boundary for this instruction. 



Note : Under System/370 this message applies 



only when the flagged statement is privileged 
instruction, a branch instruction, or an END 
instruction. 

Invalid operation code: 

1. More than eight characters. 

2. Operation entry not followed by a blank 
on same card. 

The referenced address is not within the 
range of a USING instruction. 

Operand found for an operation code which 
does not allow operands. (This message may 
be produced by the assembler if an operand is 
present in a COM, EJECT, or LTORG statement 
when the operation field has been created by 
variable symbol substitution. Operands in 
these statements are not used but are not in 
error.) 

An MNOTE statement has been generated from a 
macro definition. The text and severity code 
of the MNOTE statement is inline in the 
listing. 
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Message 
Code 



IJQ 038 
IJY 



IJQ 039 
IJY 



IJQ 040 
IJY 

IJQ 041 
IJY 



IJQ 
IJY 



IJQ 
IJY 

IJQ 
IJY 



IJQ 
IJY 

IJQ 
IJY 



IJQ 

IJY 

t. 



042 

043 
044 

045 
046 

047 



Message 
ENTRY ERROR 



INVALID DELIMITER 



GENERATED RECORD 
TOO LONG 

UNDECLARED VARIABLE 
SYMBOL 



SINGLE TERM LOGICAL 
EXPRESSION IS NOT A 
SETB SYMBOL 

SET SYMBOL PREVIOUSLY 
DEFINED 

SET SYMBOL USAGE 
INCONSISTENT WITH 
DECLARATION 

ILLEGAL SYMBOLIC 
PARAMETER 

AT LEAST 1 RELOCATABLE 
Y-TYPE CONSTANT IN 
ASSEMBLY 

SEQUENCE SYMBOL 
PREVIOUSLY DEFINED 



Meaning 



More than 100 ENTRY operands in this 

program. 

A symbol in the ENTRY operand: 

a. Appears in more than one ENTRY 
statement . 

b. Is defined in a dummy section. 

c. Is defined in blank common. 

d. Is equated to a symbol defined by an 
EXTRN or WXTRN statement. 

e. Is equated to a value less than 
start of CSECT. 



Any syntax error. 

1. A symbol has other than alphameric 
characters . 

2. A symbol begins with other than alpha 
characters . 

3. Excessive right parenthesis. 

4. Equal sign encountered in a sublist. 

5. Any terminating character encountered in 
an unexpected place. 

6. Mispunched op code causes unexpected 
syntax scan. 

7. A missing delimiter. 

8. A special character that is not a valid 
delimiter but is used as a delimiter. 

9. A delimiter used illegally. 

10. A missing operand: nothing appearing 
between delimiters. 

11. Unpaired parenthesis. 

12. An embedded blank- 
Record has more than 187 characters. 



Variable symbol is not declared in 

a define SET symbol statement or in a macro 

prototype . 

Single term logical expression is 
only valid for a SETB symbol. 



SET symbol previously defined. 



A SET symbol has been 'declared as : 

1. Undimensioned but it is subscripted. 

2. Subscripted but it is undimensioned. 

Attribute requested for a variable symbol 
which is not a symbolic parameter. 

One or more relocatable Y-type constants in 
assembly; relocation may result in 
address greater than 2 bytes in length. 

Sequence symbol previously defined. 
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Message 
Code 

h 



IJQ 048 
IJY 



IJQ 049 
IJY 

IJQ 050 
IJY 



IJQ 051 
IJY 



IJQ 


052 


IJY 




IJQ 


053 


IJY 




IJQ 


054 


IJY 




IJQ 


056 


IJY 




IJQ 


057 


IJY 





IJQ 059 
IJY 



Message 



SYMBOLIC PARAMETER 
PREVIOUSLY DEFINED OR 
SYMBOL DECLARED AS 
SYSTEM VARIABLE 
SYMBOLIC PARAMETER 



VARIABLE SYMBOL MATCHES 
A PARAMETER 

INCONSISTENT GLOBAL 
DECLARATIONS 



PROGRAMMER MACRO DEFINITION 
PREVIOUSLY DEFINED 



NAME FIELD CONTAINS 
ILLEGAL SET SYMBOL 

GLOBAL DICTIONARY FULL 



LOCAL DICTIONARY FULL 



ARITHMETIC OVERFLOW 



SUBSCRIPT EXCEEDS 
MAXIMUM DIMENSION 



UNDEFINED SEQUENCE 
SYMBOL 



Meaning 



1. Symbolic parameter previously defined. 

2. System variable symbol declared as a 
symbolic parameter. 



Variable symbol matches a parameter. 



A global SET variable that is defined in more 
than one macro definition, or in a macro 
definition and in the source program, is 
inconsistent in SET type or dimension. 

Programmer macro prototype operation entry 
is identical to a: 

1. Machine instruction. 

2. Assembler instruction. 

3. Previous programmer macro prototype. 

This message is not produced when a 
programmer macro matches a system macro. The 
programmer macro will be assembled with no 
indication of the corresponding system macro. 

SET symbol in name entry does not correspond 
to SET statement type. 

Global dictionary is full. Assembly 

is terminated. See Appendix H for dictionary 

size limits. 

Local dictionary is full. Assembly 

is terminated. See Appendix H for dictionary 

size limits. 



Intermediate or final result of an 
arithmetic operation is less than -2 31 
greater than 2 31 -1. 



or 



1 



SSYSLST or symbolic parameter subscript: 

a. Exceeds 100 (200 for F assembler) . 

b. Is negative. 

Symbolic parameter subscript is zero. 
SET symbol subscript exceeds dimension. 



Operand sequence symbol does not appear as a 
sequence symbol in a name field. 
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Message 
Code 

\- 

IJQ 060 
IJY 



IJQ 061 
IJY 

IJQ 062 
IJY 



IJQ 063 
IJY 

IJQ 064 
IJY 

IJQ 065 
IJY 



IJQ 066 
IJY 



IJQ 068 
IJY 

IJQ 069 
IJY 

IJQ 070 
IJY 



IJQ 071 
IJY 

IJQ 072 
IJY 



Message 



ILLEGAL ATTRIBUTE 
NOTATION 



ACTR COUNTER EXCEEDED 



GENERATED STRING GREATER 
THAN 127 [255] CHARACTERS 



EXPRESSION 1 OF SUBSTRING 
IS ZERO OR MINUS 

EXPRESSION 2 OF SUBSTRING 
IS ZERO OR MINUS 

INVALID OR ILLEGAL TERM 
IN ARITHMETIC 
EXPRESSION 



UNDEFINED OR DUPLICATE 
KEYWORD OPERAND 



GENERATION TIME DICTIONARY 
AREA OVERFLOWED 

EXPRESSION 2 OF SUBSTRING 
GREATER THAN 8 CHARACTERS 

FLOATING POINT CHARACTERISTIC 
OUT OF RANGE 



ILLEGAL OCCURRENCE OF 

LCL r GBL, or ACTR STATEMENT 

ILLEGAL RANGE ON ISEQ 
STATEMENT 



Meaning 






L*, S*, or I' requested for a parameter 
whose type attribute does not allow these 
attributes to be requested. 



Conditional assembly loop counter 
exceeded — conditional assembly terminated. 

Generated string is greater than 127 
characters for D assembler or 255 characters 
for F assembler. 

Expression 1 of substring is not allowed 
to be zero or minus. 

Expression 2 of substring is not allowed 
to be zero or minus. 

1. The parameter is not a self -defining 
term. 

2. The value of the SETC symbol used in 
the arithmetic expression is not 
composed of decimal digits. 

1. A keyword operand occurs more than 
once in a macro instruction. 

2. Keyword is not defined in prototype. 

See Appendix H for dictionary size limits. 



Expression 2 of substring is not 
allowed to be greater than 8 . 

Exponent too large for length of 

defining field; exponent modifier has caused 

loss of all significant digits. 

Local or Global declaration, or ACTR 
Statement is out of proper sequence. 

Operand of ISEQ statement has 
an illegal range. 



'V.__J"' 
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Message 
Code 



IJQ 073 
IJY 



IJQ 074 
IJY 



IJQ 075 
IJY 



IJQ 076 
IJY 

IJQ 077 
IJY 



IJQ 
IJY 


078 


IJQ 
IJY 


079 


IJQ 
IJY 


080 


IJQ 
IJY 


081 



IJQ 082 



IJQ 083 
IJY 



IJQ 084 
IJY 



Message 

ILLEGAL NAME FIELD 



ILLEGAL STATEMENT IN 
COPYCODE OR SYSTEM MACRO 



ILLEGAL STATEMENT 
OUTSIDE OF A MACRO 
DEFINITION 



SEQUENCE ERROR 



ILLEGAL CONTINUATION 
CARD 



MACRO MNEMONIC OP-CODE 
TABLE OVERFLOW 

ILLEGAL STATEMENT IN 
MACRO DEFINITION 

ILLEGAL START CARD 



ILLEGAL FORMAT IN GBL 
OR LCL STATEMENT 

ILLEGAL DIMENSION 
SPECIFICATION IN GBL OR 
LCL STATEMENT 

SET STATEMENT NAME 
FIELD NOT VARIABLE 
SYMBOL 

ILLEGAL OPERAND FIELD 
FORMAT IN CONDITIONAL 
ASSEMBLY STATEMENT 



Meaning 



1. Name entry required to be blank is not 
blank. 

2. Required name entry is missing. 

3. Name entry required to be a sequence 
symbol is not a sequence symbol. 



1. Statement encountered in COPY code is 
not legal in COPY code. 

2. Statement encountered in system macro is 
not legal in system macro. 

Statement allowed only in a macro 

definition encountered in OPEN code, 

e.g., period asterisk (.*) , mnote statement. 

Statement not in sequence specified 
by ISEQ instruction. 



1. 
2. 



3. 



Too many continuation cards. 

Nonblanks occur between the begin and 

continue columns of the continuation 

card. 

Card not intended as continuation was 

treated as such because of punch in 

continue column of preceding card. 



Macro mnemonic operation code table has an 
overflow. See Appendix H. 

This operation is not allowed within a 
macro definition. 

Statement affecting, or depending upon, 
the location counter have been encountered 
before a START statement. 

An operand is not a variable symbol. 



Dimension is not within the limits of 1-255. 



The name entry of a SET statement must 
be a variable symbol. 



Syntax invalid, e.g., AIF statement 
Operand does not start with a left 
parenthesis or, sequence symbol missing in 
operand field of AIF or AGO statement. 
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Message 
Code 



IJQ 085 
IJY 



IJQ 086 
IJY 



IJQ 087 
IJY 

IJQ 088 
IJY 



IJQ 089 
IJY 



IJQ 090 
IJY 



IJQ 091 
IJY 



IJQ 092 
IJY 



IJQ 093 
IJY 



IJQ 094 
IJY 



Message 

INVALID SYNTAX IN 
EXPRESSION 



ILLEGAL USAGE OF SYSTEM 
VARIABLE SYMBOL 



NO ENDING APOSTROPHE 



UNDEFINED OPERATION 
CODE 



INVALID ATTRIBUTE 
NOTATION 



INVALID SUBSCRIPT 



INVALID SELF-DEFINING 
TERM 



INVALID FORMAT FOR 
VARIABLE SYMBOL 



UNBALANCED PARENTHESES 
OR EXCESSIVE LEFT 
PARENTHESES 



INVALID OR ILLEGAL 
NAME OR OPERATION IN 
PROTOTYPE STATEMENT 



Meaning 

1. Invalid delimiter. 

2. Too many terms in expression. 

3. Too many levels of parentheses, 

4. Two operators in succession. 



1. System variable symbol appears in: 

a. The name entry of a SET statement. 

b. A mixed-mode macro definition. 

c. A keyword macro definition. 

d. A GBL or LCL statement. 

2. SSYSLIST in context other than N" 
SYSLIST. 

End of card encountered before an 
ending apostrophe. 

1 . Symbol in operation code field does not 
correspond to a valid machine or 
assembler operation code or to any 
operation code in a macro prototype 
statement . 

2. An inner macro is not defined. The 
opcode of the macro is not printed. 

The argument of the attribute reference 
must be a symbolic parameter and the 
statement must be within a macro definition. 

Syntax error, e.g., no right parenthesis 
after subscript; double subscript where 
single subscript is required, or single 
subscript where double subscript is required. 

1. Value is too large. 

2. Value is inconsistent with the data 
type, e.g., hex for decimal, etc. 

1. Variable symbol is no longer 
than 8 characters. 

2. First character after the ampersand is 
not alphabetic. 

3. Failure to use double ampersand in TITLE 
card or character self-defining term. 

End of statement or card encountered 
before all parenthesis levels are 
satisfied. May, be caused by embedded blank 
or other unexpected terminator, or failure to 
have a punch in continuation column. 

1. Name not blank or variable symbol. 

2. Variable symbol in name field is 
subscripted. 

3. Violation of rules for forming variable 
symbol, (must begin with ampersand (6) 
followed by 1-7 letters and/or numbers 
first of which must be a letter) . 

4. Statement following 'MACRO* is not a 
valid prototype statement. 






V 
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Message 
Code 



O 



IJY 095 



IJQ 096 
IJY 



IJQ 097 
IJY 



Message 



IJQ 098 
IJY 



IJQ 099 
IJY 



IJQ 100 
IJY 

IJQ 101 
IJY 



ENTRY TABLE OVERFLOW 



MACRO INSTRUCTION OR 
PROTOTYPE OPERAND 
EXCEEDS 127 [225] 
CHARACTERS IN LENGTH 

INVALID FORMAT IN MACRO 
INSTRUCTION OPERAND OR 
PROTOTYPE PARAMETER 



Meaning 



Number of ENTRY symbols , i.e., ENTRY 
instruction operands, exceeds 100. 

Macro instruction or prototype 
operand length exceeds 127 
characters for D assembler and 
255 characters for F assembler. 

1. Illegal equal sign (=) . 

2. A single ampersand (S) appears 
somewhere in the standard 

value assigned to a prototype keyword 
parameter. 

3. First character of a prototype parameter 
is not an ampersand. 

4. Prototype parameter is a subscripted 
variable symbol. 

5. Invalid usage of alternate format in 
prototype (see example) . 

6. Invalid prototype parameter, e.g., SA* 
or SASS. 



Note: Occurrence of this error will cause 



only syntax to be checked for the remainder 
of the macro definition. 



Example 
r t — 



T T 1 

| | Continuation | 
| Name | Operation | Operand j Column j 

| JPROTO |SA, SB, | | 

II I or j | 

| JPROTO |SA, SB, j X j 
II I SC | | 

I X X . X J 



EXCESSIVE OF 

OPERANDS OR PARAMETERS 



POSITIONAL MACRO 
INSTRUCTION OPERAND 
PROTOTYPE PARAMETER 
OR EXTRA COMMA FOLLOWS 
KEYWORD 

STATEMENT COMPLEXITY 
EXCEEDED 

EOD on SYSIN or SYSIPT 



1. The prototype has more than 100 

(200 for F assembler) parameters. 

2. The macro instruction has more than 100 

(200 for F assembler) operands. 

Positional macro instruction operand 
prototype parameter or extra 
comma follows keyword. 



See Appendix H for statement complexity 
limits. 

End of data reached before an END 
statement was encountered. 
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Message 
Code 



IJQ 102 
IJY 



IJQ 103 
IJY 



IJQ 104 
IJY 



IJQ 105 
IJY 



IJY 


106 


IJQ 
IJY 


107 


IJQ 
IJY 


108 


IJQ 
IJY 


109 


IJY 


110 



Message 

INVALID OR ILLEGAL IGTL 



ILLEGAL NAME IN 
OPERAND FIELD OF COPY 
CARD 

COPY CODE NOT FOUND 



EOD ON SOURCE STATEMENT 
LIBRARY 



NOT NAME OF DSECT 



INVALID OPERAND 



PREMATURE EOD 



PRECISION LOST 



EXPRESSION VALUE 
TOO LARGE 



Meaning 



1. Operands of ICTL statements are 
out of range. 

2. ICTL is not the first statement in the 
input deck. 



Syntax error, e.g., symbol has an 
illegal character or has more than 
8 characters. 

The operand of a COPY statement 
specified COPY text which cannot be 
found in the library. 

1. Mend statement missing from macro 
definition. 

2. While editing a macro, COPY code not 
found. Macro definition truncated. 

3. End of file encountered while reading a 
macro or copy code. 

4. The statement immediately preceding 
BKEND in a copy book has a nonblarik 
character in its continuation column. 

Referenced symbol expected to be DSECT name, 
but it is not. 

Operand unrecognizable, contains invalid 
value, or incorrectly specified. 

Indicates a machine error or an internal 
assembler error. 

High order information lost by attempting 
to express constant in a field not long 
enough to contain it. 

Value of expression greater than 
-16777216 to +16777215. 

Expressions in EQU and ORG statements are 
flagged if (1) they include terms previously 
defined as negative values, or (2) positive 
terms give a result of more than three bytes 
in magnitude. The error indication may be 
erroneous due to (1) the treatment of 
negative values as three-byte positive 
values, or (2) the effect of large positive 
values on the location counter if a control 
section begins with a START statement having 
an operand greater than zero, or a control 
section is divided into subsections. 



\-_-^ 
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Messages ending with an I are printed on both SYSLST and SYSLOG unless one of the 
messages indicates that SYSLST or an unidentifiable unit is defective, in which case 
they will appear on SYSLOG only. The messages appearing on SYSLOG will be prefaced by 
S A S regardless of which assembler produced them. 1101 and 1111 errors can be detected 
at any point during assembly — amount of assembly listing printed is unpredictable. 
1121 through 1151 errors are detected immediately upon assembly attempt — no assembly 
listing is printed. In either case the assembly is terminated, the source is bypassed 
to a /* or EOF, and control returned to the supervisor via EOJ. The subsequent steps 
of a multiple step JOB are not bypassed unless they are also defective. 



Message 
Code 

H 



o 



IJQ 1101 



IJQ 1111 
IJY 



IJQ 1121 
IJY 



Message 



ABORT — PERM I/O ERROR 



ABORT — UNEXPECTED EOF 
ON SYSxxx 



ABORT — INADEQUATE 
CORE FOR 32L [44K] 
ASSEMBLER 



Meaning 



An unrecoverable error on the designated unit 
prevents further processing. If the file 
named is SYSxxx, the unit code of the DTF 
which caused the error does not match any 
unit valid in the assembler. 

The assembler does not support multivolume 
work files. Determine the cause of EOF 
(usually short tape) and rerun with adequate 
storage for work files. 



Cause : An attempt was made to execute the 



[32K] D assembler in less than 14K, or the F 
assembler in less than U4K. 

This is probably a user error. 

System Action : The job step is terminated. 



Programmer Action : If there is insufficient 



main storage available, you must linkage edit 
a smaller assembler. 

If the problem recurs, do the following to 
complete your problem determination action: 

1. Execute the MAP command and retain the 
output . 

2. Have the printer output available. 

Operator Action : Execute the MAP command to 
determine the partition size. Then allocate 
a larger partition for the assembly. 
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Message 
Code 



IJQ 1131 



Message 



ABORT— INVALID 
PHYSICAL UNIT FOR 
SYSxxx 



Meaning 



Cause ; The assignments for a work file (s) 



are not valid. 

• The device type is not valid, or the 10K 
version of the D assembler is linkage 
edited for different devices than those 
assigned. 

• The UA (unassign) or IGN (ignore) option 
was specified for the D assembler. 

• The specified mode setting is not valid. 

• For the 10K version of the D assembler, 
the work file device types are not 
consistent. (SYS003 is correct.) 

Only the first invalid unit is named in the 
message. 

This is probably a user error. 

System Action ; The job step is terminated. 



Programmer Action : Use the LISTIO output to 



determine the cause for the message 

Correct the assignments and resubmit the job. 

If the problem recurs, do the following to 
complete your problem determination action: 

1. Have the LISTIO output available. 

2. Have the job stream and system output 
available. 

Operator Action : Issue the LISTIO command to 



check the assignments and enter the correct 
work file assignments if possible. 



V_y 
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Message 
Code 



o 



IJQ 1141 



IJY 1141 



Message 



ABORT — NO UNIT ASSIGNED FOR 
SYSPCH (for D assembler) 



ABORT— NO UNIT 
ASSIGNED FOR SYSxxx 

(OPTION SYM) 

(for F assembler) 



Meaning 



Cause 



For the D assembler, the OPTION 



[DECK] is in effect and SYSPCH is not 
assigned. 

This is probably a user error. 



System Action ; The job step is terminated. 



Programmer Action : Submit an assign for 



SYSPCH, 



or 

specify OPTION [NODECK] and resubmit the job. 

If the problem recurs, do the following to 
complete your problem determination action: 

1. Retain the LISTIO listing. 

2. Have the job stream, program listing, 
and system log available. 

Operator Action : Execute the LISTIO command 
and verify assignments. Submit an assign for 
SYSPCH and rerun the job. 

Cause : For the F assembler, a required unit 



(SYS001-SYS003 or a device required by 
an OPTION statement) is unassigned, or the 
IGN option is specified for the device. The 
(ignore) option is valid for SYSPCH and 
SYSLST. 

This is probably a user error. 

System Action : The system terminates the jot 
step. 

Programmer Action : Submit an assignment for 
the indicated logical unit, 

or 

correct the OPTION statement to eliminate the 
requirement and resubmit the job. 

If the problem recurs, have the LISTIO 
listing, the system log, the job stream, and 
the printer output available to complete your 
problem determination action. 

Operator Action : Execute the LISTIO command 
and verify the assignments. Submit an assign 
for the indicated logical unit and rerun the 
job. 
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Message 

Code 



j. f ___ + j 



IJY 1151 



IJQ 1161 



Message 



ABORT— INVALID DUAL 
ASSGN SYSPCH- 
SYSIPT [SYSLST] 



ABORT-INVALID MULTIPLE 
EXTENTS FOR WORKFILES 
(for the D assembler) 



Meaning 



Cause ; SYSPCH and SYSIPT are both assigned 



to the same unit, which is not a 1442N1 or 
2 52 OB 1 card reader. 



or 



SYSPCH and SYSLST are both assigned to the 
same unit, which is not a disk. 

This is probably a user error. 

System Action ; The job step is terminated. 



Programmer Action ; Check the LIST 10 listing 
to determine the dual assignments. Reassign 
the indicated logical units to separate 
devices, or the required device type. 

If the problem recurs, retain the LISTIO 
output, the job stream, system log, and 
supervisor listing to complete your problem 
determination action. 

O perator Action ; Execute LISTIO to determine 
the current assignments. Reassign the two 
indicated logical units to separate devices 
or to the required device type. 

Cause ; For the D assembler, more than one 
extent is assigned for SYS001, SYS002, 
or SYS003. 

System Action ; The job step is terminated. 



Programmer Action ; Probable user error. 
Correct extent job control statement. If the 
problem persists do the following before 
calling for IBM programming support. 

• Execute the LSERV program and save its 
output . 

• Have the associated jobstream and program 
listing available. 

Operator Action ; None . 

i i. ,. jl J 

Figure 35. Assembler Diagnostic Error Messages (Part 14 of 14) 

Note ; If the execution of the assembler is terminated abnormally with the message 4950A 
NO MORE AVAILABLE EXTENTS, on the console , one of the assembler work files has been 
filled. This is probably caused by a conditional assembly loop resulting from a logical 
error in the source code. To locate the error, ACTR statements should be included in 
each macro definition and in the main portion of the source code. The programmer must 
also make sure that a MACRO statement is included to identify the beginning of each 
macro definition. Otherwise the statements of the definition are included in the main 
portion of the program. 
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Self- relocating programs are executed in a 
multiprogramming environment and at any 
location in main storage. These programs 
may be located in either foreground area of 
main storage. A program that is 
self-relocating must initialize its address 
constants , including channel command words 
(CCWs) at execution time. The user must 
code his own self-relocating routine for 
execution after it is linkage edited and 
loaded into main storage. 

When coding a self-relocating program, 
the programmer should take these points 
into consideration: 

1 . All A-type address constants must be 
relocated. 

2. The I/O area addresses in all CCWs 
must be relocated. 

3. Address constants generated by 
physical IOCS macros (EXCP, WAIT, 
etc.) must be relocated. 

4 . Logical IOCS macros can be 

self -relocated using the OPENR macro. 

The following example program shows how 
a user may code a self-relocating program. 
This example uses the A-type constant and 
registers 1 and 2 although the user may use 
any of the other available registers if he 
chooses. 



This program contains six address 
constants. Two are A-type and two each are 
contained in the command control block 
(CCB) and the channel command word (CCW) 
macros. This procedure is used: 



1. The absolute addresses of the contents 
of the two A-type constants (EOFTAPE 
and CHA12) and the CCW for each CCB 

(PRINTCCW and TAPECCW) are loaded into 
a work register (register 1) . 

2. The work register is stored in the 
address constants [A (EOFTAPE) and 
A(CHA12)] and in their respective CCBs 

(PRINTCCB+8 and TAPECCB+8) . 

3. The command code for the CCWs shares a 
fullword with the I/O area address and 
must be reset after the I/O area 
address has been stored. This is done 
here by two methods : (a) saving the 
command code for the PRINTCCW in 
register 2 and then restoring it; (b) 
using the the Move Immediate (MVT) 
instruction for the TAPECCW to set the 
command code. 

In the main routine of this program, 
note that register notation has been used 
with the EXCP and WAIT macros to avoid the 
generation of address constants by the 
macros themselves . The example of a 
self- re locating program follows. 
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SOURCE STATEMENT 



PRINT NOGEN 
PROGRAM START 

BALR 15,0 

USING *,15 
* ROUTINE TO RELOCATE ADDRESS CONSTANTS 





LA 


1, PRINTCCW 




ST 


1,PRINTCCB+8 




LA 


1 , TAPECCW 




ST 


1,TAPECCB+8 




LA 


1, EOFTAPE 




ST 


1 , AEOFTAPE 




LA 


1,CHA12 




ST 


1 ,ACHA12 




IC 


2, PRINTCCW 




LA 


1 , OUTAREA 




ST 


1 , PRINTCCW 




STC 


2, PRINTCCW 




LA 


1, INAREA 




ST 


1 , TAPECCW 




MVI 


TAPECCW, 2 


* MAIN ROUTINE. ..READ TAPE AND PRIN 


READTAPE 


LA 


1 , TAPECCB 




EXCP 


(D 




WAIT 


(1) 




L 


10, AEOFTAPE 




BAL 


14, CHECK 




MVC 


OUTAREA (10) , INAREA 




MVC 


OUTAREA+15 (70) ,INAREA+10 




MVC 


OUTAREA+90 (20) , INAREA* 80 




LA 


1 , PRINTCCB 




EXCP 


(1) 




WAIT 


(D 




L 


10,ACHA12 




BAL 


14, CHECK 




B 


READTAPE 


CHECK 


TM 


4(1) ,1 




BCR 


1,10 




BR 


14 


CHA12 


MVI 


PRINTCCWfX^B* 




EXCP 


0) 




WAIT 


(D 




MVI 


PRINTCCW, 9 




BR 


14 


EOFTAPE : 


EOJ 






CNOP 


0,4 


PRINTCCB 


CCB 


SYS004 , PRINTCCW, X* 0400* 


TAPECCB 


CCB 


SYS001, TAPECCW 


PRINTCCW 


CCW 


9,OUTAREA,X'20',110 


TAPECCW 


CCW 


2, INAREA, X* 20', 100 


AEOFTAPE 


DC 


A (EOFTAPE) 


ACHA12 


DC 


A(CHA12) 


OUTAREA 


DC 


CL110' • 


INAREA 


DC 


CL100' • 




END 


PROGRAM 



RELOCATE CCW ADDRESS 

IN CCB FOR PRINTER 
RELOCATE CCW ADDRESS 

IN CCB FOR INPUT TAPE 
♦RELOCATE***** 

* PROGRAM * 

* ADDRESS * 
♦♦♦♦CONSTANTS* 

SAVE PRINT CCW OP CODE 
RELOCATE OUTPUT AREA ADDRESS 

IN PRINTER CCW 
RESTORE PRINT CCW OP CODE 
RELOCATE INPUT AREA ADDRESS 

IN TAPE CCW 
SET TAPE CCW CODE TO READ 
T RECORDS 
GET CCB ADDRESS 
READ ONE RECORD FROM TAPE 
WAIT FOR COMPL. OF I/O 
GET ADDRESS OF TAPE EOF ROUTINE 
GO TO UNIT EXCEPTION SUBROUTINE 
EDIT RECORD 

IN 

OUTPUT AREA 
GET CCB ADDRESS 
PRINT EDITED RECORD 
WAIT FOR COMPL. OF I/O 
GET ADDRESS OF CHAN 12 ROUTINE 
GO TO UNIT EXCEPTION SUBROUTINE 

CHECK FOR UNIT EXC. IN CCB 
YES-GO TO PROPER ROUTINE 
NO- RETURN TO MAINLINE 

SET SK TO CHAN 1 OP CODE 

SK TO CHAN 1 IMMEDIATELY 

WAIT FOR COMPL. OF I/O 

SET PRINTER OP CODE TO WRITE 

RETURN TO MAINLINE 

END OF JOB 

ALIGN CCB'S TO FULL WORD 



V, 



y 
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O 



The second macro definition is MOVE. 
This macro is recursive; i.e., it calls 
itself as an inner macro. Compare this 
macro definition with MOVE in Appendix I 
MOVE in Appendix I has more statements, 
however it functions differently and 
includes error checking facilities. 



The macro definitions in this appendix are 
typical applications of the macro language 
and conditional assembly. Another macro 
definition is included as part of Appendix 
I. The definitions are presented along 
with statements generated from typical 
corresponding macro instructions. 

The first macro definition is NOTE — a 
DOS system macro taken from the source 
statement library of the DOS assembler. 

MACRO 
&LABEL NOTE fcFILEN 

.* IBM SYSTEM/360 TAPE/DISK OPERATING SYSTEM 
» CHANGE LEVEL 2-0 

(T'fcFILEN NE •O'J.ONE 

0,*N0 FILENAME SPECIFIED. SET TO ••*••• 

1,=A(») »#***ERR0R-PATCH DTF TABLE ADDRESS 

.THREE 

(•&FILENU1,1) NE MM. TWO 

(•&FILENU)* EQ MM. FOUR 

ltSFlLENU) GET DTF TABLE ADDRESS 

.THREE 



ELABEL 



.ONE 



&LABEL 



.TWO 

6LABEL 

.THREE 

.FOUR 

SLABEL 

.FIVE 



AIF 

MNOTE 

L 

AGO 

AIF 

AIF 

LR 

AGO 

ANOP 

L 

L 

AGO 

ANOP 

L 

BAL 

MEND 



lt*AUFILEN) 

15,16(1) 

.FIVE 

15 f 16U) 
14,12(15) 



GET DTF TABLE ADDRESS 
GET LOGIC MODULE ADDRESS 



GET LOGIC MODULE ADDRESS 
BRANCH TO NOTE ROUTINE 



STATEMENTS GENERATED FROM NOTE MACRO INSTRUCTIONS 



• SYMBOL AS OPERAND 

NNAME NOTE INFILE 

♦* CHANGE LEVEL 2-0 

♦NNAME L lt-AC INFILE) GET DTF TABLE ADDRESS 

♦ L 15,16(1) GET LOGIC MODULE ADDRESS 

♦ BAL 14,12(15) BRANCH TO NOTE ROUTINE 



• REGISTER 1 AS OPERAND 

NOTE (1) 
♦» CHANGE LEVEL 2-0 

♦ L 15,16(1) GET LOGIC MODULE ADDRESS 

♦ BAL 14,12(15) BRANCH TO NOTE ROUTINE 



OTHER REGISTER AS OPERAND 



■ 1 



NOTE (5) 
♦• CHANGE LEVEL 2-0 

♦ LR 

♦ L 

«• BAL 



1,5 GET DTF TABLE ADDRESS 
15,16(1) GET LOGIC MODULE ADDRESS 
14,12(15) BRANCH TO NOTE ROUTINE 
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• OMITTED OPERAND 

NOTE 

♦ • CHANGE LEVEL 2-0 

OfNO FILENAME SPECIFIED. SET TO ••• 

♦ L 1,«A<#) •••##ERROR-PATCH DTF TABLE ADDRESS 

♦ L 15tl6(l) GET LOGIC MODULE ADDRESS 

♦ BAL 14,12(15) BRANCH TO NOTE ROUTINE 



6NAME 






6B 

• PN 
6NAME 
6A 
£B 



• DO 
fiNAME 
6 A 



MACRO 

MOVE 6FR0M,6T0,£C0UNT 



RECURSIVE GENERAL PURPOSE MOVE MACRO 



GBLA £A 
LCLA SB 
SETA 
AIF 
MVC 



fiCOUNT 

(GB LE 256). DO 

£T0*6A.(256),6FR0M+6A 



SETA &A+256 
SETA 6B-256 



MOVE 

MEXIT 

ANOP 

MVC 

SETA 

MEND 



6FR0M,fiT0,£B 



6T0+£A.UB)»GFROM«-£A 




MOVE LESS THAN 256 BYTES 
256 BYTE MOVE 



CALL THYSELF 



LESS THAN 256 BYTE MOVE 
SET BACK TO FOR NEXT CALL 



STATEMENTS GENERATED FROM MOVE MACRO INSTRUCTIONS 



• MOVE LESS THAN 256 BYTES 

MNAME MOVE FRMAD, TOAD, 150 
♦MNAME MVC T0AD+0(150)tFRMAD*0 LESS THAN 256 BYTE MOVE 



MOVE 256 BYTES 

MOVE FRMAD, TOAD, 256 

MVC T0AD*0(256),FRMAD+0 LESS- THAN 256 BYTE MOVE 



• MOVE MORE THAN 256 BYTES 

MNAME2 MOVE FRMAD, TOAD, 400 

♦MNAME2 MVC T0AD+0<256> ,FRMAD*0 256 BYTE MOVE 

♦ MVC T0AD+256U44),FRMAD+256 LESS THAN 256 BYTE MOVE 



MOVE MORE THAN 512 BYTES 



MOVE FRMAD, TOAD, 520 

MVC T0AD+0(256),FRMAD*0 256 BYTE MOVE 

MVC T0AD+256(256),FRMAD+256 256 BYTE MOVE 

MVC T0AD+512(8),FRMAD+512 LESS THAN 256 BYTE MOVE 
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&SYS, restrictions on use 76,88,101 
&SYSECT (see Current control section name) 
&SYSLIST (see macro instruction operand) 
&SYSNDX (see macro instruction index) 
&SYSPARM (see system parameter for 

conditional assembly) 
7090/7094 Support Package Assembler 13,170 
Absolute terms 20 
ACTR instruction 97 
Address constants 56 

A- type 57 

Complex relocatable expressions 57 

Literals not allowed 25 

S-type 57 

V-type 58 

Y-type 57 
Address specification 42 
Addressing 31 

Dummy sections 36 

Explicit 31 

External control sections 39 

Implied 31 

Relative 34 
AGO instruction 96 

Example 96 

Form of 96 

Inside macro definitions 96 

Operand field of 96 

Outside macro definitions 96 

Sequence symbol in 96 

Use of 96 
| AGOB instruction 13,7 5 
AIF instruction 95 

Example of 95 

Form of 95 

Inside macro definitions 

Invalid operand fields of 

Logical expression in 95 

Operand field of 95 

Outside macro definitions 

Sequence symbols in 95 

Use of 95 

Valid operand fields of 96 
| AIFB instruction 13,75 
Alignment, boundary 

CNOP instruction for 65 

Machine instruction 41 
Ampersands in 

Character expressions 92 

Macro-instruction operands 79 

MNOTE instruction 99 

Symbolic parameters 74 

Variable symbols 72 



95 
95 



95 



ANOP instruction 97 

Example of 97 

Form of 97 

Sequence symbol in 97 

Use of 97 
Apostrophes in 

Character expressions 91 

Macro instruction operands 77 

MNOTE instruction 99 
Arithmetic expressions 

Arithmetic relations 94 

Evaluation procedure 89 

Invalid examples of 89 

Operand sublists 90 

Operators allowed 88 

Parenthesized terms in 89 
evaluation of 89 
examples of 8 9 

SETA instruction 88 

SETB instruction 93 

Substring notation 91,92 

Terms allowed 88 

Valid examples of 88 
Arithmetic relations 94 
Arithmetic variable 104 
Assembler instructions 

Statement 46 

Table 144 

(see specific instructions) 
Assembler language 13 

Basic Operating System 13 

Basic Programming Support 13,170 

Coding conventions 16 

Comparison chart 170 

Macro facilities, relation to 71 

Statement format 17 

Structure 19,20 
Assembler program 

Basic functions 12 

DOS/TOS relationship 15 

Listing 160 

Output 3 4,183 

Variants 182 
Assembler relationships 15 
Assembling a Program 174 

Assemble-and-execute 13,178,181 

Card Input 174,178,181 

Device Assignments 176,177 

Diagnostic Error Messages 187 

I/O Units Used 179,180 

Operating Considerations 176,177 

Output 183 
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Assembly, terminating an 67 
Assembly no operation (see ANOP 

instruction) 
Attributes 84 

How referred to 85 

Inner macro instruction operands 84 

Kinds of 84 

Notations 84 

Operand sublists 84 

Outer macro instruction operands 84 

Summary chart of 151 

Use of 84 

(see also specific attributes) 



Basic Programming Support Assembler 13, 170 
Base Registers 

Address calculation 15,39,42 

DROP instructions 32 

Loading of 31 

USING instructions 31 
Binary constant 53 
Binary self-defining term 24 
Binary variable 104 
Bit length specification 49 

Mutiple constants 50 

Multiple operands 50 

Duplicated constants 50 
Blanks 

Logical expressions 93 

Macro instruction operands 79 



CCW instruction 6 

Channel command word, defining 6 

Character codes 113 

Character constant 51 

Character expressions 91 

Ampersands in 91 

Character relations 94 

Concatenating 92 

Examples of 91 

Periods and 91 

Apostrophes in 91 

SETB instructions 93 

SETC instructions 90 
Character relations 94 
Character self-defining term 24 
Charcter set 19,20,112 
Character variable 104 
CNOP instruction 65 
Coding form 17 
COM instruction 36 

Commas, macro instruction operands 79 
Comments entries 18 
Comments statements 

Examples of 19,78 

Model statements 78 

Not generated 78 
Comparison chart 70 
Compatibility between System/360 
assemblers 12 

DOS/TOS assembler variants 12 

DOS/TOS assemblers and OS assemblers 13 

DOS/TOS assemblers and BOS/BPS 
assemblers 13 

Macro-definitions 111 



Complex relocatable expressions 57 
Concatenation 

Character expressions 91,92 

Defined 77 

Examples of 77 

Substring notations 91 
Conditional assembly elements, summary 

charts of 97,150 
Conditional assembly instructions 

How to write 83 

Summary of 98 

Use of 83 

(see also specific instructions) 
Conditional branch (see AIF instruction) 
Constants (see also specific types) 

Defining (see DC instructions) 

Summary of 147 
Continuation lines 16 
Conditional branch instruction 44 

Operand format 4 3,44 
Control section location assignment 35 
Control sections 

Blank common 36 

CSECT instruction 35,36 

Defined 34 

DSECT instruction 36 

First control section, properties of 35 

START instruction 35 

Unnamed 36 
COPY instruction 66 
COPY statements in macro definitions 

Form of 78 

Model statements, contrasted 78 

Operand field of 78 

Use of 78 
Count attribute 

Defined 86 

Notation 84 

Operand sublists 86 

Use of 86 

Variable symbols 86 
CSECT instruction, symbol in, length 

attribute of 35, 36 
Current control section name (&SYSECT) 

Affected by CSECT, DSECT, START 105 

Example of 106 

Use of 105 



Data definition instructions 47 
Channel command words 60 
Constants 47 
Storages 58 
Data representation 15 
DC instruction 47 

Duplication factor operand subfield 48 
Operand subfield modifiers 48 
Type operand subfield 48 
Length modifier 48 
Scale modifier 50 
Exponent modifier 51 
Constant operand subfield 51 
Address-constants (see address 
constants) 
Binary constant 53 
Character constant 52 
Decimal-constants 56 
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DC instruction (continued) 

Fixed-point constants 53 

Floating-point constants 54 

Hexadecimal constant 52 

Type codes for 50 
Decimal constants 56 

Length modifier 56 

Length, maximum 56 

Packed 54 

Zoned 54 
Decimal field, integer attribute of 87 
Decimal self-defining terms 91 
Defining constants (see DC instruction) 
Defining storage (see DC instruction; 

DS instruction) 
Defining symbols 22,83 
Diagnostic Error Messages 187 
Dimension, subscripted SET symbols 104 
Displacements 42 
Double-shift instruction 42 
DROP instruction 32,42 
DS instruction 58 

Defining areas 59 

Forcing alignment 59 
DSECT instruction 36 

Dummy section location assignment 36,38 
Duplication factor 48 

Forcing alignment 59 



Effective address length 43 

EJECT instruction 61 

END instruction 67 

ENTRY instruction 38,39 

Entry point symbol, identification of 38 

EQU instruction 46 

Equal signs, as macro instruction 

operands 79 
Error message (see MNOTE instruction) 
Error Messages 187 

After END statement 67 
Explicit addressing 31,42 

Length 42 
Exponent modifiers 51 
Expressions 26,27,38 

Absolute 42 

Character 91 

Evaluation 27 

Logical 94 

Relocatable 42 

Summary chart of 150 
Extended mnemonic codes 44 

Operand format 45 

Table 123 
External control section, addressing of 39 
External symbol, identification of 39 
EXTRN instruction 39 



First control section 35 
Fixed-point constants 53 

Format 53 

Positioning of 53 

Scaling 54 

Values, minimum and maximum 53,54 
Fixed-point field, integer attribute 
of 86 



Floating-point constants 54 

Alignment 55 

Format 55 

Scale modifiers 55 
Floating-point field, integer attribute 

of 87 
Format cjontrol, input 63 



GBLA instruction 

Form of 101 

Inside macro definitions 101 

Outside macro definitions 101 

Use of 101 
GBLB instruction 

Form of 101 

Inside macro definitions 101 

Outside macro definitions 101 

Use of 101 
GBLC instruction 

Form of 101 

Inside macro definitions 101 

Outside macro definitions 101 

Use of 101 
General register zero, base register 

usage 32 
Generated statements, examples of 77 
Global SET symbols 

Defining 101 

Examples of 101,102,103 

Local SET symbols, compared 100 

Using 101 
Global variable symbols 

Types of 100 

(see also global SET symbols, sub- 
scripted SET symbols) 



Hexadecimal constants 52 
Hexadecimal -decimal conversion chart 
Hexadecimal self -defining terms 23 



I' (see Integer attribute) 
ICTL instruction 63 
Identification-sequence field 19 
Identifying blank common control 

section 37,38 
Identifying assembly output 60,61 
Identify dummy section 36 
Implied addressing 31,42 

Length 42 
Implied length specification 42 
Inner macro instruction 

Defined 79 

Example of 82 

Symbolic parameters in 82 
Instruction alignment 41 
Instruction format 19 
Interger attributed 

Decimal fields 87 

Examples of 87 

Fixed-point fields 87 

Floating-point fields 87 

How to compute 87 

Notation 84 

Restrictions on use 87 
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Integer attributed (continued) 

Use of 87 
ISEQ instruction 63 



K' (see Count attribute) 
Keyword 

Defined 108 

Keyword macro instruction 108 

Symbolic parameter and 107 
Keyword, inner macro instructions used 

in 109 
Keyword macro definition 

Positional macro definitions 107 

compared 107 

Use 107 
Keyword macro instruction 

Example of 109 

Format of 108 

Keywords in 108 

Operands 68,108 

Invalid examples 109 

Valid examples 109 

Operand sublists in 109 
Keyword prototype statement 

Examples of 108,109 

Format of 108 

Operands 108,109 

Invalid examples 108 
Valid examples 108 

Standard values 108 



L' (see Length attribute) 
LCLA instruction 

Form of 88 

Use of 88 
LCLB instruction 

Form of 88 

Use of 88 
LCLC instruction 

Form of 88 

Use of 88 
Length modifier 48 

Bit length specification 49 
Lengths explicit and implied 42,43 
Length attribute 

Defined 43,85 

Examples 85 

Notation 84 

Restrictions on use 86 

Symbols 22,86 

Use of 85, 86 
Length modifier 48 

Length subfield 41 
Level of parentheses 26 
Library, copying coding form 66 
Linkage symbols (see also ENTRY 
instruction; EXTRN instruction) 

Entry point symbol 38 

External symbol 38 

Linkage editor and use of 38 
Listing, spacing 61,62 
Listing control instructions 60 
Literal pools 26,64,65 

Segments one to four 65 



25 



65 
26 



Literals 25 

Character 42 

DC instruction, used in 

Duplicate 26 

Format 25 

Literal pool, beginning 

Literal pools, multiple 

Treatment of self-defining term 25 
Local SET symbols 

Defining 101 

Examples of 101,102,103 

Global SET symbols, compared 100 

Using 101 
Local variable symbols 

Types of 100 

(see also local SET symbols) 

(see also subscripted SET symbols) 
Location counter 46,51,57 

Predefined symbols 23 

References to 23 

Setting 64 
Logical expressions 

AIF instructions 95 

Arithmetic relations 94 

Blanks in 94 

Character relations 94 

Evaluation of 94 

Invalid examples of 94 

Logical operators in 94 

Parenthesized terms in 
Evaluation of 94 
Examples of 94 

Relation operators in 94 

SETB instructions 93 

Terms allowed in 94 

Valid examples of 94 
LTORG instruction 64,65 



Machine features required 9 
Machine instructions 41 

Alignment and checking 41 

Length 43 

Literals, limits on 25 

Mnemonic operation codes 43 

Operand fields and subfields 41 

Symbolic operand formats 43 
Machine-instruction mnemonic codes 43 

Alphabetical listing 12 3 
MACRO 

Form of 74 

Use 74 
Macro definition 

Compatibility 111 

Defined 74 

Example of 76 

How to prepare 74 

Keyword (see Keyword macro definition) 

Mixed-mode (see Mixed-mode macro 
definition) 

Placement in source program 74 

Sample 162,203,204 

Use 74 
Macro definition exit (see MEXIT 

instruction) 
Machine instruction examples and format 

RR 41,43,44 
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Machine instruction examples and format 
(contined) 

RX 41,44 

RS 41,44 

SI 41,44 

SS 41,44 

Summary table 120,121 
Macro definition header statement (see 

MACRO) 
Macro definition trailer statement (see 

MEND) 
Macro facility 

Additional features 97,98 

Comparison chart 173 

Relation to assembler language 71 

Summary 98,149 
Macro instruction 

Defined 71 

Example of 80 

Form of Z9 

How to write 79 

Levels of 82 

Inner 82 

Mnemonic operation code 79 

Name entry of 79 

Omitted operands 80 
Example of 80 

Operand entry of 79 

Operands 

Ampersands 80 
Blanks 80 
Commas 80 
Equal signs 80 
Paired parentheses 79 
Paired apostrophes 79 

Operand sublists 80,81 

Operation entry of 79 

Outer 81 

Statement form 80 

Types of 69 

Used as model statement" 81 
Macro instruction index (&SYSNDX) 

AIF instruction 104 

Arithmetic expressions 104 

Character relation 104 

Example 105 

MNOTE instruction 104 

SETB instruction 104 

SETC instruction 105 

Use of 104 
Macro instruction operand (&SYSLIST) 

Attributes of 106 

Use of 106,109 

(see also symbolic parameters) 
Macro instruction prototype statement 

(see prototype statement) 
Macro instruction statement (see macro 

instruction) 
MEND 

Form of 74 

MEXIT instruction, contrasted 99 

Use of 74 
MEXIT instruction 

Example of 99 

Form of 99 

MEND, contrasted 99 

Use of 99 



Mixed-mode macro definitions 

Positional macro definitions 
contrasted 110 

Use 109,110 
Mixed-mode macro instruction 

Example of 110 

Form of 110 

Operand field of 69,110 
Mixed-mode prototype statement 

Example of 110 

Form of 110 

Operands of 110 
Mnemonic operation codes 4 3 

Extended 44 

Machine instruction 4 3 

Macro instruction 74 
MNOTE instruction 

Ampersands in 100 

Error message 100 

Example of 100 

Operand entry of 99,100 

Apostrophes in 100 

Severity code 100 

Use of 99 
Model statements 

Comments field of 76 

Comments statements 78 

Defined 75 

Name field of 7 5 

Operation field of 75 

Operand field o'f 76 

Use of 75 



N' (see Number attribute) 
Name entries 18 
Number attribute 

Defined 86 

Notation 86 

Operand sublist 86 



Object deck 183 
Object module 34 
Operands 

Entries 17,18 

Fields 41 

Subfields 41,42 

Symbolic 38,41,43 
Operand sublist 

Alternate statement form 81 

Defined 80 

Example of 81 

Use of 81 
Operation codes 

Assembler 14 

Machine 14 
Operation entries 17,18 
Operation field 41 
Ordinary symbol 22 
ORG instruction 64 
Outer macro instruction defined 



Paired parentheses 79 
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Paired apostrophes 79 
Parentheses in 

Arithmetic expressions 89 

Logical expressions 94 

Macro instruction operands 79,80 

Operand fields and subfields 4 2 

Paired 79 
Period in 

Character expressions 91 

Comments statements 78 

Concatenation 78 

Sequence symbols 87 
Positional macro definition (see macro 

definition) 
Positional macro instruction (see macro 

instruction) 69 
Previously defined symbols 23 
PRINT instruction 62 
Program control instructions 62 
Program listings 15 

Program sectioning and linking 21,31,34 
Prototype statement 

Alternate 75 

Example of 75 

Form of 74 

Keyword (see keyword prototype state- 
ment) 

Mixed-mode (see mixed-mode prototype 
statement) 

Name entry of 74 

Operand entry of 74 

Operation entry of 74 

Statement form 74,75 

Symbolic parameters in 74 

Use of 74 
PUNCH instruction 63,64 



Relational operators 94 
Relative addressing 34 
Relocatability 15,20 

Attributes 38 

Program, general register zero 32 
Relocatable expressions 28,41 

In USING instructions 32 
Relocatable symbols 22 
Relocatable terms 

Pairing of 27 

In relocatable expressions 28 
REP card 186 
REPRO instruction 64 
RR machine instruction format 41,42 

Length attribute 41 

Symbolic operands 4 3 
RS machine instruction format 41,4 2 

Address specification 42 

Length attribute 41 

Symbolic operands 4 3 
RX machine instruction format 41,42 

Address specification 42 

Length attribute 41 

Symbolic operands 4 3 



S' (see scaling attribute) 

Sample macro definitions 161,203,204 

Sample program 160 



Scale modifier 

Fixed-point constants 50 
Floating-point constants 50,51 

bCd.X lily «"Ct.irX.D\l"C@ 

Decimal fields 85,86 
Defined 85 

Fixed-point fields 85,86 
Floating-point fields 85,86 
Notation 102 
Restrictions on use 86 
Symbols 85,86 
Use of 85,86 
Self-defining terms 23,24 
Binary 24 
Character 24 
Decimal 23 
Hexadecimal 23 
Using 23 

(see also specific terms) 
Sequence checking 63 
Sequence symbols 22,86,87 
AGO instruction 96 
AIF instruction 95,96 
ANOP instruction 97 
How to write 86,87 
Invalid examples of 87 
Macro instruction 87,88 
Use of 87 

Valid examples of 87,88 
Set symbols 

Assigning values to 83 
Defining 83 

Symbolic parameters, contrasted 83 
Use 83 

(see also local SET symbols) 
(see also global SET symbols) 
(see also subscripted SET symbols) 
SET variable 100,101 
SETA instruction 

Examples of 89,90 

Form of 88 

Operand entry of 88 

Evaluation procedure 89 

Operators allowed 88 

Parenthesized terms 89 

Terms allowed 88 

Valid examples of 88 
Operand sublist 90 

Example 90 
SETB instruction 
Example of 95 
Form of 93 
Logical expression in 94 

Arithmetic relations 94 

Blanks in 94 

Character relations 94 

Evaluation of 94 

Operators allowed 94 
Operand entry of 93,94 

Invalid examples of 94 

Valid examples of 94 
SETC instruction 
Apostrophes 90 
Character expressions in 90 

Ampersands 90 

Periods 90 
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SETC instruction (continued) 
Concatenation in 

Character expressions 91 

Substring notations 91,92 
Examples of 90,91,92 
Form of 90 
Operand entry of 90 
Substring notations in 91,92 

Arithmetic expressions in 92 

Character expressions in 92 

Invalid examples of 92 

Valid examples of 92 
Type attribute in 90,91 

Example of 91 
SETA symbol 

Assigning values to 83 
Defining 83 
SETA instruction 89 
Using 89 
SETB symbol 

AIF instruction 95,96 
Assigning values to 83 
Defining 83 
SETA instruction 95 
SETB instruction 95 
SETC instruction 95 
Using 95 
SETC symbol 

Assigning values to 83 
Defining 83 
SETA instruction 94 
Using 93 

Severity code in MNOTE instruction 100 
SI machine instruction format 44 

Address specification 42 

Length attribute 41 

Symbolic operands 4 3 
Source module 34 

Source statement library defined 7 2 
SPACE instruction 61,62 
SS machine instruction format 41,4 4 

Address specification 42 

Length attribute 41 

Length field 42 

Symbolic operands 43 
START instruction 

Positioning of 34 

Unamed control sections 35 
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